Basecamp Sherpa
AppsAgent

Deploy

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

Quick deploy

pnpm agent:deploy

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

How it works

Build

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

  1. deps — installs pnpm dependencies
  2. build — runs pnpm --filter agent build (Vite SSR bundle)
  3. runtime — slim Node 22 image with Claude Code CLI and Basecamp CLI pre-installed

Push

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

ghcr.io/yannickarmspach/sherpa-agent: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-agent:latest

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

Production

Deploy the Agent to Railway.

Endpoints

Agent HTTP routes and server functions.