Configuration

Configuration

All variables are optional. By default the stack serves the bundled stable game data and the web app is at http://localhost:8725. Set them in a .env next to compose.yaml (or in a service's environment:).

MCP server (sf-mcp)

Variable	Description
SATISFACTORY_GAME_CHANNEL	Bundled channel: stable (default) or experimental.
SF_GAME_DATA_PATH	Full path to your own merged sf-game-data.json, overriding the bundled data.
MCP_TRANSPORT	stdio (child-process clients) or http (network; the Docker default).
MCP_HTTP_HOST	HTTP bind host when MCP_TRANSPORT=http (default 0.0.0.0).
MCP_HTTP_PORT	HTTP port when MCP_TRANSPORT=http (default 8723).
SAVE_DATA_DIR	Directory of uploaded playthrough saves (shared with the backend).

The server no longer parses a raw en-US.json at runtime — it loads a pre-built merged dataset (bundled, or SF_GAME_DATA_PATH). See Game data channels.

Foreman backend (ff-server)

Variable	Description
ANTHROPIC_API_KEY	Server-wide Anthropic key (the default provider). Unset → each client supplies its own.
ANTHROPIC_MODEL	Model override (default claude-sonnet-4-6).
LLM_PROVIDER / LLM_API_KEY / LLM_MODEL / LLM_BASE_URL	Run on an OpenAI-compatible provider instead (OpenAI, OpenRouter, Gemini, …).
DATABASE_URL	SQLite database location (defaults into the foreman-db volume).
BETTER_AUTH_SECRET / BETTER_AUTH_URL / AUTH_TRUSTED_ORIGINS	Accounts / session cookies (a secret is auto-generated and persisted if unset).

See compose.yaml and the README for the full list and details.