Skip to main content
Open console

Node.js

A Node application serving its own HTTP — Next.js, Nuxt, Express or anything else that listens on a port

2 min read

A Node application serving its own HTTP — Next.js, Nuxt, Express or anything else that listens on a port. Replaces PHP-FPM and nginx rather than joining them: it is the web server as well as the application. In front of it is the platform's proxy, which terminates TLS, routes the hostname and compresses responses; behind it, whatever the project chose.

The container runs as vallic with the release at /var/www/html/current (WEB_ROOT), read-only, and the release's own node_modules/.bin on PATH. The release keeps node_modules: for a Node application they are the runtime, not a build input, so the build's last step prunes what production does not need.

To run the same project on Bun instead, write bun: under runtime in place of node:. To run one beside a backend in another language, see Multi app (beta).

A Next.js project

vallic.yaml at the root of the repository:

version: 1
type: nodejs

runtime:
  node: '24'

build:
  steps:
    - name: Dependencies
      run: npm ci
    - name: Build
      run: npm run build
    - name: Production dependencies only
      run: npm prune --omit=dev
  cache:
    - node_modules
    - .next/cache

start: npm start
port: 3000

health:
  path: /
  timeout: 30

npm start is next start, which serves the .next directory the build produced and listens on PORT. Both start and port are the defaults, so they can be left out; they are written here so the file says what runs. Next.js binds HOSTNAME, which the platform sets to 0.0.0.0, and NODE_ENV is production.

Uploads and anything else written at runtime go under /mnt/files (VALLIC_PUBLIC_DIR, VALLIC_PRIVATE_DIR), which outlive the release; the release itself is read-only. Environment variables — a database URL, an API key — are set on the environment in the console and reach the process as ordinary environment variables, not as an .env file in the checkout.

The npm in the image is 12, whichever Node line runs: a dependency's install scripts run only where package.json allows them, and git or URL dependencies only where .npmrc does. A build that needs npm 11 installs with npx -y npm@11 ci. See npm 12.

Versions

Version Status
26.13 Supported
26.11 Supported, and the default
26.12 Supported
24.21 Supported
24.22 Supported
22.23 Supported

Pin the version, not the build: name 26.11 and the platform matches it to the current build, so a security rebuild reaches you without anybody editing a repository.

What you can change

In vallic.yaml — what each one does is on Service settings:

services:
  - nodejs:
      version: '26.11'
      environment:
        NODE_OPTIONS: …

Anything not on this list refuses the deploy, naming the variable — rather than being accepted and quietly ignored.

Need a hand?

Open a ticket from Support in the console. We answer on the ticket.

Open the console How support works