Skip to main content

Production-Local Mode

Run a production-like Aurora stack locally for testing and evaluation.

Overview​

Production-local mode uses production Docker images but runs entirely on your machine. This is ideal for:

  • Testing before deploying to production
  • Evaluating Aurora without cloud infrastructure
  • Demo environments

Commands:

  • make prod-prebuilt — Pull prebuilt images from GHCR and start (no build, fastest).
  • make prod-local — Build from source and start (for feature branches or custom builds).

Commands​

# First-time setup
make init

# Start (prebuilt images from GHCR)
make prod-prebuilt

# Or build from source and start
make prod-local

# View logs
make prod-logs

# Stop
make down

# Clean (removes volumes, preserves .env)
make prod-clean

# Full cleanup
make prod-nuke

Vault Setup​

Vault automatically initializes on first startup. The root token is stored in the vault-init container logs.

Get the Root Token​

docker logs vault-init 2>&1 | grep "Root Token:"

You'll see output like:

===================================================
Vault initialization complete!
Root Token: hvs.xxxxxxxxxxxxxxxxxxxxxxxxxxxx
IMPORTANT: Set VAULT_TOKEN=hvs.xxxxxxxxxxxxxxxxxxxxxxxxxxxx in your .env file
===================================================

Add Token to .env​

nano .env
# Add: VAULT_TOKEN=hvs.xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Restart to Apply​

make down
make prod-prebuilt   # or: make prod-local to build from source

Service Endpoints​

ServiceURLDescription
Frontendhttp://localhost:3000Web UI
Backend APIhttp://localhost:5080REST API
Chatbotws://localhost:5006WebSocket
Vault UIhttp://localhost:8200Secrets management
SeaweedFShttp://localhost:8333S3-compatible storage

Testing Vault​

Verify Vault is working:

# Write a test secret
docker exec -it vault vault kv put aurora/users/test-secret value='hello'

# Read it back
docker exec -it vault vault kv get aurora/users/test-secret

Differences from Development​

Aspectmake devmake prod-prebuilt / make prod-local
Docker imagesDevelopmentProduction
Hot reloadEnabledDisabled
OptimizationsOffOn
Use caseContributingTesting/Eval

Troubleshooting​

"Secrets not generated" Error​

make init
make prod-prebuilt   # or: make prod-local to build from source

Vault Connection Issues​

  1. Check Vault is running: docker ps | grep vault
  2. Check token is in .env: grep VAULT_TOKEN .env
  3. Restart: make down && make prod-prebuilt (or make prod-local)

Port Conflicts​

Ensure these ports are free: 3000, 5080, 5006, 5432, 6379, 8080, 8200, 8333

Next Steps​