Quickstart¶
Five minutes from nothing to a runtime that appears in Multica.
1. Create a Multica token¶
Open https://multica.ai/settings?tab=tokens and create a personal access token. Copy it once — the UI will not show it again.
2. Get the configuration¶
git clone https://github.com/ProReka/multica-runtime.git
cd multica-runtime
cp .env.example .env
Open .env and fill in four values:
MULTICA_TOKEN=mul_...
AI_BASE_URL=https://api.anthropic.com
AI_API_KEY=sk-ant-...
AI_MODEL=claude-sonnet-4-5
Using a router? See Configuration → Routers. OpenCode
can use an OpenAI-compatible surface; Claude Code needs an Anthropic-compatible
one. With AI_PROTOCOL=auto the image probes the router and picks the right
adapter for OpenCode.
3. Start it¶
docker compose up -d
docker compose logs -f runtime
The first log lines tell you what was resolved:
[multica] Multica Runtime v0.2.0 (base)
[multica] Versions claude=2.1.314 | opencode=1.19.5 | multica=0.7.2 | ...
[multica] AI protocol=anthropic | provider=multica | model=claude-sonnet-4-5
[multica] Paths workspaces=/workspaces | claude=/workspaces/.claude | ...
[multica] Logging in to Multica…
[multica] Starting Multica daemon (foreground)…
4. Check the dashboard¶
Open Multica → Runtimes. You should see one runtime per bundled CLI
(Claude Code and OpenCode) registered under the name from
MULTICA_AGENT_RUNTIME_NAME.
Bind an agent to one of them and assign it a task. The container stays in the
foreground; work happens in /workspaces/<task-id>.
5. Pick the right image (optional)¶
The base image is enough for most tasks. If your repository needs a toolchain, switch the tag:
MULTICA_IMAGE=ghcr.io/proreka/multica-runtime:php
docker compose up -d
The PHP image starts MariaDB, PostgreSQL and Redis inside the container before the daemon. See Variants for the full list.
Common first-time questions¶
Do I need to expose a port? No. The runtime is an outbound worker: it connects to Multica and your AI endpoint. There is no inbound service.
Where do sessions go?
/workspaces/.claude and /workspaces/.opencode/data, on the
multica-workspaces volume. Restarting or upgrading the container keeps them.
Can I run more than one runtime?
Yes — use a different MULTICA_DAEMON_ID and container name per role. Do not run
two containers with the same daemon id; they will compete for tasks.
Does it work on Apple Silicon?
Yes. linux/amd64 and linux/arm64 images are published. Flutter is amd64-only
because the Android build tools are.
How do I update?
docker compose pull && docker compose up -d. Pin a version tag if you want
upgrades to be explicit.