Docker deployment

Use the shortest safe path to launch local team mode, then enable semantic profile only when needed.

Docker deploy (open-source, team-ready)

The commands below are aligned with the current context8-docker design.

bash

# 1) Clone
git clone https://github.com/context8/context8-docker.git
cd context8-docker

# 2) Agent-ready setup (interactive + start + smoke)
./scripts/configure_context8_docker.sh --up --smoke

# 3) Deterministic non-interactive setup
./scripts/configure_context8_docker.sh   --non-interactive   --api-base "http://localhost:8000"   --enable-semantic false   --enable-federation false   --up   --smoke

bash

API_BASE=http://localhost:8000

# Check admin bootstrap status
curl -fsS "$API_BASE/auth/status"

# First-time admin setup
curl -fsS -X POST "$API_BASE/auth/setup"   -H "Content-Type: application/json"   -d '{"username":"admin","password":"<strong-password>"}'

# Login
curl -fsS -X POST "$API_BASE/auth/login"   -H "Content-Type: application/json"   -d '{"identifier":"admin","password":"<strong-password>"}'

bash

# configure_context8_docker.sh --up auto-installs context8-mcp when npm exists
# Manual fallback if auto-install is skipped/failed:
npm install -g context8-mcp
context8-mcp remote-config --remote-url "http://localhost:8000" --api-key "<api-key>"
context8-mcp diagnose
context8-mcp list --limit 1

bash

API_BASE=http://localhost:8000
API_KEY=<your-api-key>

curl -fsS "$API_BASE/status/summary"
curl -fsS -X POST "$API_BASE/search"   -H "Content-Type: application/json"   -H "X-API-Key: $API_KEY"   -d '{"query":"timeout","limit":5,"offset":0,"source":"local"}'
curl -fsS "$API_BASE/mcp/solutions?limit=1&offset=0" -H "X-API-Key: $API_KEY"

Open context8-docker repo Backend API README

Update flow (npm-like)

Use the dedicated update script for pull + recreate + health checks. This is the recommended way to keep Docker deployment current.

bash

# Default update (npm-like)
./scripts/update_context8_docker.sh

# Roll back to an exact image version
CONTEXT8_VERSION=v1.2.2 ./scripts/update_context8_docker.sh

# Switch registry channel
CONTEXT8_REGISTRY=ghcr.io/context8 ./scripts/update_context8_docker.sh
# or
CONTEXT8_REGISTRY=docker.io/<org_or_user> ./scripts/update_context8_docker.sh

# Optional one-shot Watchtower update
./scripts/update_context8_docker_once_watchtower.sh

Semantic profile

When you need vector kNN ranking, enable semantic profile and embedding service.

bash

# Enable semantic search in .env
ES_KNN_WEIGHT=1
ES_BM25_WEIGHT=1

# Start semantic profile (adds embedding service)
docker compose --profile semantic up -d --pull always