hanzoai/nodejs

The one canonical Node base image for every Hanzo Node service.

• Node 24 (LTS "Krypton", pinned node:24.18.0-alpine)
• sqlite3 bundled, two ways — both proven at build time:
  1. require('node:sqlite') — the built-in DatabaseSync (Node ≥ 22.5). Zero deps.
  2. Native npm sqlite (better-sqlite3, sqlite3) compiles against the baked-in toolchain (build-base + python3 + sqlite-dev) via node-gyp.

Use

One way. In any Hanzo Node service's Dockerfile:

FROM ghcr.io/hanzoai/nodejs:v24.18.0

Pin the exact semver (v24.18.0). The moving major tag v24 also exists but consumers must pin the patch for reproducible builds.

Verify

docker run --rm ghcr.io/hanzoai/nodejs:v24.18.0 node -e "require('node:sqlite');console.log('ok')"

Release

Tag vX.Y.Z where X.Y.Z matches the pinned Node version in the Dockerfile. CI (hanzo-build-linux-amd64, self-hosted) builds linux/amd64 and publishes ghcr.io/hanzoai/nodejs:vX.Y.Z + :vX. Never :latest, never :sha.