Skip to content

Install

Vladimir Kochnev edited this page Nov 17, 2026 · 1 revision

Install

Release archives

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 --version

Container images

ghcr.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.

systemd user units

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.service

Sets started from the panel are child processes of the panel; mcprig-set@ is the alternative for running one set without the manager.

First run

  1. Open the panel (http://127.0.0.1:9091/), sign in.
  2. All servers → Add server: a stdio command or a remote URL, plus its environment. Check probes it before you commit.
  3. In a set: Servers → attach the server, Start.
  4. Keys → issue a key; the token is shown once. The client connects to http://<host>:<set port>/mcp with Authorization: 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.

Clone this wiki locally