Repository navigation
Install
Vladimir Kochnev edited this page Nov 17, 2026
·
1 revision
Each release publishes one static binary per platform (CGO_ENABLED=0,
-trimpath, -s -w):
| property | value |
|---|---|
| OS / arch | linux, darwin × amd64, arm64 |
| archive | mcprig_<version>_<os>_<arch>.tar.gz |
| contents |
mcprig, README.md, README.ru.md, LICENSE, the deploy/*.service units |
| checksums |
checksums.txt next to the archives |
V=0.6.5
curl -LO https://github.com/akrhin/mcprig/releases/download/v$V/mcprig_${V}_linux_amd64.tar.gz
curl -LO https://github.com/akrhin/mcprig/releases/download/v$V/checksums.txt
sha256sum -c checksums.txt --ignore-missing
tar xzf mcprig_${V}_linux_amd64.tar.gz
install -Dm755 mcprig ~/.local/bin/mcprig
mcprig --versionghcr.io/akrhin/mcprig:<version>-slim, <version>-full, latest, latest-full.
slim is the proxy and the panel; full adds the sandbox helpers. The panel
listens on MCPRIG_PORT (default 9091) and answers /healthz, which is what
the container healthcheck uses.
| unit | what it runs |
|---|---|
mcprig.service |
mcprig panel — registry, supervision, panel |
mcprig-set@.service |
mcprig serve --config … — one set as its own service |
mcprig-warm@.service + @.timer
|
mcprig warm --set %i, keeps a set warm |
install -Dm755 mcprig ~/.local/bin/mcprig
install -Dm644 deploy/mcprig.service deploy/mcprig-set@.service ~/.config/systemd/user/
install -d -m700 ~/.config/mcprig ~/.local/state/mcprig
printf 'MCPRIG_PASSWORD=%s\n' 'change-me' > ~/.config/mcprig/panel.env
chmod 600 ~/.config/mcprig/panel.env
systemctl --user daemon-reload
systemctl --user enable --now mcprig.serviceSets started from the panel are child processes of the panel; mcprig-set@ is
the alternative for running one set without the manager.
- Open the panel (
http://127.0.0.1:9091/), sign in. -
All servers → Add server: a
stdiocommand or a remote URL, plus its environment. Check probes it before you commit. - In a set: Servers → attach the server, Start.
-
Keys → issue a key; the token is shown once. The client connects to
http://<host>:<set port>/mcpwithAuthorization: Bearer <token>.
State lives in MCPRIG_DATA_DIR (default ~/.local/state/mcprig): the registry,
per-set configs, keys, logs and OAuth tokens.
Details: docs/en/install.md.