Basecamp Sherpa
AppsConsole

Deploy

Build and push the Console Docker image to ghcr.io.

Quick deploy

pnpm console:deploy

Builds the Console Docker image and pushes it to ghcr.io/yannickarmspach/sherpa-console:latest. Railway automatically pulls the updated image.

How it works

Build

The Dockerfile at apps/console/Dockerfile runs a multi-stage build:

  1. deps — installs pnpm dependencies (console + shared UI)
  2. build — runs pnpm --filter console build (Vite SSR bundle)
  3. runtime — slim Node 22 image running node serve.js on port 3001

Push

The image is pushed to GitHub Container Registry (private):

ghcr.io/yannickarmspach/sherpa-console:latest

Pull

Railway is configured to pull from ghcr.io with registry credentials. After pushing, Railway detects the new image and redeploys automatically.

Prerequisites

  • Docker with buildx enabled
  • Authenticated with ghcr.io: docker login ghcr.io
  • Railway service configured to pull from ghcr.io/yannickarmspach/sherpa-console:latest

For Railway setup (env vars, domain, LemonSqueezy webhooks), see Production.

Production

Deploy the Console to Railway.

Endpoints

Console HTTP routes, API endpoints, and server functions.