Docker & Container Deployment
Because NodeStack has zero native C++ compilation steps and uses Node's embedded SQLite engine, deploying with Docker is lightweight, fast, and secure.
1-Click Railway Deployment
You can deploy NodeStack directly to Railway with zero configuration:
Railway will automatically build the container via Dockerfile, attach persistent volume storage to /app/nodestack_data, and provide a production HTTPS domain.
Production Multi-Stage Dockerfile
A production Dockerfile is included at the repository root:
# Stage 1: Build & Compile
FROM node:24-alpine AS builder
WORKDIR /app
COPY package*.json ./
COPY packages ./packages
COPY examples ./examples
RUN npm ci
COPY tsconfig.json ./
COPY src ./src
COPY bin ./bin
COPY scripts ./scripts
RUN npm run build:server
RUN npm prune --omit=dev
# Stage 2: Minimal Production Runner
FROM node:24-alpine AS runner
WORKDIR /app
ENV NODE_ENV=production
ENV NODESTACK_HOST=0.0.0.0
ENV NODESTACK_PORT=8090
ENV NODESTACK_DATA_DIR=/app/nodestack_data
COPY --from=builder /app/package.json ./package.json
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/bin ./bin
COPY --from=builder /app/packages ./packages
EXPOSE 8090
VOLUME ["/app/nodestack_data"]
CMD ["node", "bin/nodestack.js", "start"]
Docker Compose
Create a docker-compose.yml:
version: '3.8'
services:
nodestack:
image: nodestack:latest
build: .
restart: unless-stopped
ports:
- "8090:8090"
environment:
- NODESTACK_PORT=8090
- NODESTACK_HOST=0.0.0.0
- NODESTACK_DATA_DIR=/app/nodestack_data
- NODESTACK_JWT_SECRET=${JWT_SECRET}
volumes:
- nodestack_volume:/app/nodestack_data
volumes:
nodestack_volume:
Launch with:
docker compose up -d