Install the Engine

Run the public Apache 2.0 Engine locally with Docker, then replace development defaults before exposing it.

Local Docker sandbox

git clone https://github.com/Tegence/synaxis-engine
cd synaxis-engine
docker build -t synaxis-engine .
docker run --rm -p 8080:8080 \
  -e ENGINE_ISSUER=http://localhost:8080 \
  -e ENGINE_DEVELOPMENT_MODE=true \
  synaxis-engine

ENGINE_DEVELOPMENT_MODE=true generates temporary bootstrap secrets and prints the local password in the process logs. With --rm and the default file store, this sandbox is intentionally disposable. Do not use development mode for a reachable deployment.

Before production

Set unique ENGINE_PASSWORD and ENGINE_SECRET values, turn development mode off, and put the Engine behind HTTPS.

Use the exact public origin for ENGINE_ISSUER. Add DATABASE_URL and ENGINE_ENCRYPTION_KEY for durable encrypted credential storage. Local console login is opt-in through ENGINE_LOCAL_ADMIN_AUTH_ENABLED=true; leave it off if another control plane manages the Engine.

Upstream compatibility

Connections use remote Streamable HTTP MCP endpoints. For production connections, use a publicly reachable HTTPS URL and authenticate with an existing bearer token, OAuth Dynamic Client Registration, or a pre-registered OAuth client.