JavaScript frameworks
Nuxt, SvelteKit, Astro, React Router, Remix, TanStack Start, Angular SSR, Gatsby and Node servers on launchroom.
Every JavaScript app that runs a server gets a preset. Apps that build to static files (Vite, Create React App, static Astro, Angular without server rendering) are served as static sites. Next.js has its own guide.
Shared by every JavaScript server
- Listen address:
HOSTandHOSTNAMEare0.0.0.0, so the server answers from outside the container. - Requests over HTTPS look like HTTPS (Express, Fastify, Hono, Koa, Nest, Astro, React Router, Remix, TanStack Start, Angular SSR): launchroom loads a small module through
NODE_OPTIONS=--import=/opt/launchroom/node/forwarded.mjs. It marks a request as secure when it reached launchroom over HTTPS, so cookies, redirects and origin checks usehttps. It is not added for Bun or Node versions before 18.18. ANODE_OPTIONSvariable you set replaces it. - Auth.js: with
next-author an@auth/*package,AUTH_TRUST_HOST=trueand a generatedAUTH_SECRET, as for Next.js. - Health check under the base path: when the app sets a base path, the health check uses it instead of
/.
Nuxt
- Start the Nitro server:
node .output/server/index.mjs. - The health check follows
app.baseURL. - The plan warns when
nuxt.configsets a Nitro preset that doesn't build a Node server.
Nuxt and its h3 server read X-Forwarded-Proto themselves, so they don't need the HTTPS module.
SvelteKit
- Start the adapter-node server: with
@sveltejs/adapter-node,node build(or theoutfolder you configured). Withadapter-auto, Railpack builds with adapter-node. - Visitor IP from the edge:
ADDRESS_HEADER=X-Forwarded-ForandXFF_DEPTH=1, sogetClientAddress()returns the visitor's IP. - The health check follows
kit.paths.base. - The plan warns about
adapter-static(no server) and adapters for other hosts. Switch to@sveltejs/adapter-node.
Astro
An Astro site without a server adapter builds to static files. With @astrojs/node in standalone mode:
- Start the Astro server:
node ./dist/server/entry.mjs. - The health check follows
base. - The plan warns about middleware mode, where
entry.mjsis a handler for your own server, and about adapters for other hosts.
React Router and Remix
React Router 7 in framework mode and Remix keep your start script. Without one, launchroom starts react-router-serve (or remix-serve) with ./build/server/index.js when it is installed, and warns otherwise. The health check follows basename.
TanStack Start
launchroom keeps the start command Railpack detects and adds the HTTPS module.
Angular with server rendering
When angular.json builds with server rendering (@angular/ssr), launchroom builds a server instead of a static site and starts node <output>/server/server.mjs.
Gatsby
Serve the production build: gatsby serve on the service's port. A Gatsby starter's start script runs the development server, so launchroom replaces it.
Node servers
Express, Fastify, Hono, Koa and Nest apps, and any other app with a package.json:
- Listen on $PORT: launchroom sets
PORT=3000. Your server must listen onprocess.env.PORT. The plan warns when the code callslisten(3000)without reading it. - Start the compiled app (Nest): runs
start:prodinstead ofnest start, which compiles at every start. - The plan warns when
package.jsonhas nostartscript ormain.
Static sites
Vite, Create React App, Angular and static Astro or Next.js exports build to files that Caddy serves on port 8080:
- Hashed assets (
/assets/,/_astro/,/_next/static/,/static/js|css|media/) are cached for a year. Everything else is revalidated on each visit. - Single-page apps fall back to
index.html. Multi-page sites (Astro, Next.js export, Gatsby) answer unknown paths with their404.htmland a 404 status. - A Vite
basesuch as/app/is served under that path.
Set RAILPACK_NO_SPA=1 as a build variable to turn off the static-site handling, or RAILPACK_SPA_OUTPUT_DIR to change the output folder.
What you might still do
- Read
process.env.PORTin your own server. - Use the Node adapter of your framework if you built for another host.
- For a monorepo, pick the app's folder as the root directory. launchroom builds from the workspace root. See monorepos.
Turn a decision off
Open Settings → Build → Preset decisions, select × on the chip and save. For example, remove Requests over HTTPS look like HTTPS if your app sets up proxy trust itself.