docker.env.example

# Optional Docker Compose interpolation settings.
# Copy to .env at the repo root: cp docker.env.example .env

JARVIS_DOCKER_UID=1000
JARVIS_DOCKER_GID=1000

# Runtime mode for all containers: cloud or local (must match config/*.env you use).
JARVIS_MODE=cloud

# Tool RAG profile used by containers. "docker" is the safe baseline.
# For hybrid Docker UI + native CLI/wake-word, use "default" and block
# container-incompatible tools in Web UI Settings (web-only blocklist).
# Keep this set to docker even when using docker-compose.mcp.yml. The MCP
# override changes only jarvis-web to docker-mcp; setting docker-mcp here would
# also apply it to base services that have no Docker CLI or socket.
JARVIS_DOCKER_TOOL_PROFILE=docker

# With docker-compose.mcp.yml: pull enabled MCP sidecar images before first start
# (see config/mcp-servers.json — stock enabled servers use mcp/fetch, mcp/brave-search).
# Missing images are skipped during init tool sync; Web UI still starts and the
# incomplete sync is retried the next time jarvis-web is recreated.

# Required only with docker-compose.mcp.yml. Socket group ID for group_add in
# docker-compose.mcp.yml (Linux hosts only in docs; experimental on Docker Desktop).
#
# Linux (native shell):
#   stat -c '%g' /var/run/docker.sock
#
# Windows PowerShell, macOS, or any host where stat does not apply — use Docker
# (same socket mount path Compose uses):
#   docker run --rm -v /var/run/docker.sock:/var/run/docker.sock alpine stat -c '%g' /var/run/docker.sock
#
# Windows with WSL 2 backend (optional; must match your Docker WSL distro):
#   wsl stat -c '%g' /var/run/docker.sock
#
# JARVIS_DOCKER_SOCKET_GID=999

# Init-time tool sync only (bin/sync-tools.py). Usually omit this line — entrypoint
# defaults to JARVIS_MODE. Set explicitly only when you need something different,
# e.g. JARVIS_SYNC_MODES="cloud local" to sync both DBs while running cloud mode.
# JARVIS_SYNC_MODES=cloud

# API auth inside containers (see docs/docker/README.md).
# Requires JARVIS_API_KEY in config/cloud.env or config/local.env.
# Overrides JARVIS_API_AUTH from those files via JARVIS_OVERRIDE_* in compose.
JARVIS_DOCKER_API_AUTH=false

# Host-side ports are configurable here. Container-side service ports remain
# fixed; change these values when a default host port is already in use.
JARVIS_WEB_PORT=5001
JARVIS_API_PORT=8880
JARVIS_CANVAS_PORT=8890
JARVIS_MEMORY_PORT=5002
JARVIS_INTELLIGENCE_PORT=5003
JARVIS_DOCS_PORT=5004