Skip to main content

Linux installation

AgentDock provides prebuilt releases for Linux x64 and ARM64. A regular installation does not require Go, Git, or the source repository.

1. Install​

Run this in a terminal:

curl -fsSL https://github.com/uvwt/agentdock/releases/latest/download/install-linux.sh \
  -o /tmp/install-agentdock.sh
sudo env AGENTDOCK_NONINTERACTIVE=true bash /tmp/install-agentdock.sh

The installer uses safe defaults, selects systemd or OpenRC, creates a low-privilege service user, generates a connection token, and completes a health check.

2. Verify the service​

For systemd:

sudo systemctl status agentdock --no-pager
curl -fsS http://127.0.0.1:8765/healthz

For OpenRC:

sudo rc-service agentdock status
curl -fsS http://127.0.0.1:8765/healthz

A healthy response contains ok: true.

3. Read the connection token​

sudo awk -F= '/^AGENTDOCK_AUTH_TOKEN=/{print $2}' \
  /etc/agentdock/agentdock.env

Save the output in a password manager. Do not paste it into chat history or commit it to Git.

4. Connect an MCP client​

When the client runs on the same Linux machine, use:

Transport      Streamable HTTP
URL            http://127.0.0.1:8765/mcp
Request header Authorization: Bearer <your token>

When AgentDock runs on a remote server, create an SSH tunnel from your own computer:

ssh -L 8765:127.0.0.1:8765 <username>@<server-address>

Keep the SSH session open and let the local client connect to the same http://127.0.0.1:8765/mcp URL.

tip

Installation is complete when the service is running, the health check succeeds, and the client has the MCP URL and token.

Update​

Download and run step 1 again. Tasks, Skills, configuration, and the working directory are preserved.

Continue when needed​