Ubuntu/Debian Linux only · amd64 + arm64

Terminal-first processd-mcp

Deploy the standalone kernel in one command, run it as a systemd service, and auto-start on boot with secure local defaults.

Open Latest Installer Back to Home

terminal install
curl -fsSL https://github.com/daimon-hq/release/releases/latest/download/install-processd-kernel.sh | sudo bash -s -- install

systemctl status processd-mcp --no-pager
curl -i http://127.0.0.1:8080/health

Install

One command install with systemd auto-start

The installer detects architecture, downloads the correct binary, verifies SHA256, writes secure defaults, and enables processd-mcp.service at boot.

curl -fsSL https://github.com/daimon-hq/release/releases/latest/download/install-processd-kernel.sh | sudo bash -s -- install

What gets installed

/usr/local/bin/processd-mcp, /etc/processd-mcp/processd-mcp.env, and /etc/systemd/system/processd-mcp.service. Defaults: MCP_HOST=127.0.0.1, MCP_PORT=8080, random PROCESSD_TOKEN.

Verify

Check service health and readiness

After installation, confirm systemd status and local health endpoint before connecting MCP clients.

sudo systemctl status processd-mcp --no-pager
sudo systemctl is-enabled processd-mcp
sudo systemctl is-active processd-mcp
curl -i http://127.0.0.1:8080/health

Expected output

The service should be enabled+active, and /health should return HTTP 204.

sudo awk -F= '/^PROCESSD_TOKEN=/{print $2}' /etc/processd-mcp/processd-mcp.env

Client auth header

Use X-Access-Token: <token> when calling /mcp or /sdk/file. /health is intentionally unauthenticated.

Policy (Optional)

Enable sandbox policy from processd-standalone sample

Terminal deployment can run without a policy, but you can enable kernel-level sandbox rules by wiring MCP_SANDBOX_POLICY_FILE.

sudo curl -fsSL https://raw.githubusercontent.com/BIGPPWONG/processd-standalone/main/sandbox-policy.example.yaml -o /etc/processd-mcp/policy.yaml
sudo chmod 644 /etc/processd-mcp/policy.yaml

echo 'MCP_SANDBOX_POLICY_FILE=/etc/processd-mcp/policy.yaml' |   sudo tee -a /etc/processd-mcp/processd-mcp.env

sudo systemctl restart processd-mcp

Policy source

This uses sandbox-policy.example.yaml from processd-standalone as the baseline template.

Operations

Upgrade, uninstall, and troubleshoot

The same installer script supports lifecycle commands, so your runbook can stay consistent.

# Upgrade kernel binary and restart service
curl -fsSL https://github.com/daimon-hq/release/releases/latest/download/install-processd-kernel.sh | sudo bash -s -- upgrade

# Uninstall service and binary
curl -fsSL https://github.com/daimon-hq/release/releases/latest/download/install-processd-kernel.sh | sudo bash -s -- uninstall

# Runtime status helper
curl -fsSL https://github.com/daimon-hq/release/releases/latest/download/install-processd-kernel.sh | bash -s -- status

Port already in use

Edit MCP_PORT in /etc/processd-mcp/processd-mcp.env and restart: sudo systemctl restart processd-mcp.

Inspect logs

Use journalctl -u processd-mcp -n 200 --no-pager to inspect startup failures.

systemd not found

This guide targets Ubuntu/Debian hosts with systemd. Non-systemd distros are out of v1 scope.