feat: provide HOST env variable at runtime (#5421)

* feat: provide HOST env variable at runtime * doc: add change to documentation * Update documentation according to suggestions Co-authored-by: Chris Swithinbank <[email protected]> * fix: empty string is considered as undefined Co-authored-by: Chris Swithinbank <[email protected]>
withastro · Nov 17, 2022 · 12236db · 12236db
1 parent ff35b47
commit 12236db
Show file tree

Hide file tree

Showing 3 changed files with 16 additions and 1 deletion.
diff --git a/.changeset/violet-buckets-repeat.md b/.changeset/violet-buckets-repeat.md
@@ -0,0 +1,5 @@
+---
+'@astrojs/node': minor
+---
+
+Allow HOST env variable to be provided at runtime
diff --git a/packages/integrations/node/README.md b/packages/integrations/node/README.md
@@ -109,6 +109,15 @@ node ./dist/server/entry.mjs
 
 For standalone mode the server handles file servering in addition to the page and API routes.
 
+
+#### Custom host and port
+
+You can override the host and port the standalone server runs on by passing them as environment variables at runtime:
+
+```shell
+HOST=0.0.0.0 PORT=3000 node ./dist/server/entry.mjs
+```
+
 #### HTTPS
 
 By default the standalone server uses HTTP. This works well if you have a proxy server in front of it that does HTTPS. If you need the standalone server to run HTTPS itself you need to provide your SSL key and certificate.

diff --git a/packages/integrations/node/src/standalone.ts b/packages/integrations/node/src/standalone.ts
@@ -39,7 +39,8 @@ export default function startServer(app: NodeApp, options: Options) {
 	const { client } = resolvePaths(options);
 	const handler = middleware(app);
 
-	const host = getResolvedHostForHttpServer(options.host);
+	// Allow to provide host value at runtime
+	const host = getResolvedHostForHttpServer(process.env.HOST !== undefined && process.env.HOST !== '' ? process.env.HOST : options.host);
 	const server = createServer(
 		{
 			client,