Node.js Deployment

Holocron builds a server-rendered application that runs on Node.js.

Build

1npx vite build

This outputs a production bundle to dist/.

Start the server

1node dist/rsc/index.js

The server listens on port 3000 by default.

Production setup

For a production deployment, you need:

Build the site (vite build)
Start the Node.js server
Reverse proxy (nginx, Caddy, etc.) for TLS and domain routing

Example with Docker

12345678FROM node:22-slim
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN corepack enable && pnpm install --frozen-lockfile
COPY . .
RUN pnpm build
EXPOSE 3000
CMD ["node", "dist/rsc/index.js"]

Example with systemd

123456789101112[Unit]
Description=Docs site
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/docs
ExecStart=/usr/bin/node dist/rsc/index.js
Restart=on-failure

[Install]
WantedBy=multi-user.target

Environment variables

Variable	Default	Description
`PORT`	3000	Server listen port

Ask AI about this page