Use Node.js 26 or later. Install dependencies with npm ci from the repository root.
The server reads repository files from PUBLIC_DIR. The default path is public/ under the current working directory. The default listener is 0.0.0.0:7100.
Set runtime values in the process environment. The application does not load .env files. Use .env.example as a list of settings, and do not commit private values.
export PUBLIC_DIR=./nodejs-repository
export HOST=127.0.0.1
export PORT=7100
npm startOpen http://127.0.0.1:7100/ in a browser. The site can return static pages without repository metadata, but /ready returns an error until the required metadata files exist.
Set REPOSITORY_ROOT to the published repository directory. Compose attaches that directory at /srv/repository as read-only and binds port 7100 to localhost.
export REPOSITORY_ROOT=./nodejs-repository
docker compose up --build -dCheck the container with docker compose ps and curl --fail http://127.0.0.1:7100/ready. View logs with docker compose logs --follow web. Stop the container with docker compose down.
The container uses node:26-bookworm-slim. It copies application code and static templates into the image. It reads repository content from the read-only directory. The image does not build RPMs or change repository files.
Run npm run build to build the optional browser bundle. Run npm run check:blogs with BLOG_DIR set to a directory of blog JSON documents. Run npm test for final validation before a commit.