Installation

Installation

FICSIT Foreman runs locally as three services — the web app (ff-client, port 8725), its backend (ff-server, 8724) and the unified MCP server (sf-mcp, 8723) — serving the bundled stable game data out of the box. To chat with the foreman you also need an LLM API key: Anthropic or OpenAI.

Pick how you want to run it:

Path	Use it when
Docker (recommended)	You have Docker installed (Docker Desktop, Docker Engine, Podman…). One docker compose up -d starts everything.
WSL Containers (preview)	Windows 11 and you'd rather use WSL's built-in wslc runtime than install Docker Desktop. Runs the same images; a few more manual steps.

Both run the identical ghcr.io/stuartmeeks/foreman-* images and end up at http://localhost:8725. When in doubt, use Docker.

For environment variables (API keys, game-data channel, database location) see Configuration.