Skip to main content

How do I host LaunchNotes on my domain as a subdirectory?

Configure LaunchNotes to appear as a subdirectory on your domain (e.g., yourdomain.com/updates) using reverse proxy configuration.

Chelsea Davis avatar
Written by Chelsea Davis
Updated this week

Summary

You can host LaunchNotes as a subdirectory on your domain (like yourdomain.com/updates) by configuring a reverse proxy through your server or cloud infrastructure. This requires technical setup through services like AWS CloudFront, Cloudflare, or server configurations (Nginx, Apache, Caddy).

Important: If you're not already familiar with everse proxy configuration, we strongly recommend using a custom subdomain instead.


AWS

For more information on how to do this with AWS, please see AWS documentation here.

If you use AWS CloudFront, make sure to:

  • Allowed HTTP Methods needs to be GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE.

  • For cache settings, choose Legacy Cache Settings options and choose All for Headers, Cookies, and Query Strings.

Cloudflare

If you are on the enterprise plan with Cloudflare, you can use page rules to accomplish a custom subdirectory, more info here.

Server Configuration

For the below examples, suppose you want to set a path prefix of /myprefix and your LaunchNotes URL SUBDOMAIN_ON_LAUNCHNOTES.launchnotes.io. Make sure to replace myprefix with the actual path you want to use and SUBDOMAIN_ON_LAUNCHNOTES with your LaunchNotes url subdomain. After changing the server configuration, restart the respective service for the changes to take effect.

Nginx

You can modify the Nginx configuration like this:

location /**myprefix** { rewrite ^/**myprefix**/(.*) /$1 break; proxy_pass https://********SUBDOMAIN_ON_LAUNCHNOTES.launchnotes.io********; proxy_set_header Host ********SUBDOMAIN_ON_LAUNCHNOTES.launchnotes.io********; }

Apache

For Apache, you'll need to enable the following modules: proxy, proxy_http, and headers. Add the following configuration to your Apache virtual host file:

apacheCopy code ProxyPass /myprefix/ https://SUBDOMAIN_ON_LAUNCHNOTES.launchnotes.io/ ProxyPassReverse /myprefix/ https://SUBDOMAIN_ON_LAUNCHNOTES.launchnotes.io/ RequestHeader set X-Forwarded-Proto https expr=%{REQUEST_SCHEME}

Caddy

For Caddy, use is the handle_path directive and reverse_proxy to our services:

handle_path /myprefix/* { reverse_proxy https://SUBDOMAIN_ON_LAUNCHNOTES.launchnotes.io }

Once you have accomplished this, please let us know as soon as possible so that we can update our internal resolvers to reflect these changes - this final step ensures that we’re configured correctly on our end for your custom subdirectory.

You can reach us at [email protected], or via live chat in your management portal.

Did this answer your question?