selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

AgentDock logo

Self-host AgentDock

v1.1.1

MCP runtime that gives AI agents access to your machines

ReleaseOpen SourceApache-2.0
Docker ComposeCompose file & guide
docker compose up -d
Updated11 hours ago
LanguageGo
Setup difficultyEasy
Stars
1 283
Port
8765 (AgentDock server: MCP Streamable HTTP endpoint (/mcp) and health check)
Docker
ghcr.io/uvwt/agentdock

What is AgentDock?

AgentDock is an open-source, Apache-2.0 licensed MCP runtime that lets AI assistants work directly on the computers, servers, and containers you operate. It exposes file reading and writing, code search, shell command execution, Git operations, browser control, and task management as MCP tools over Streamable HTTP (with an optional stdio mode), so clients such as ChatGPT, Claude, or Codex act in your real environment instead of a sandbox. Multiple AgentDock instances can coordinate across devices, optionally through the vendor's NexusDock workspace for a shared entrypoint and memory; pairing is not required, since direct local MCP access works out of the box. Extensions come as Skills, Plugins, and dynamically attached external MCP servers, and long-running tasks save checkpoints so work can resume after interruptions. Desktop users install a graphical package for macOS (13+) or Windows 11; servers use an automated script (systemd or OpenRC) or the official container image via Docker Compose, secured with a Bearer token or OAuth, and Cloudflare Tunnels provide temporary or fixed public addresses. The runtime itself is free; the paired NexusDock service offers a free plan and a paid Plus plan.

Should you self-host AgentDock?

AgentDock scores 53/100 on selfhost.directory (how scoring works) and ranks #81 of 209 in AI Agents. It has 1 283 GitHub stars.

It shipped 5 stable releases in the past year. The latest, v0.9.2, came out on 25 October 2026. New versions land roughly every 3 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Orca (91/100, 108 555 stars). It scores higher overall, so compare the two before you pick. See AgentDock vs Orca side by side.

Features

  • AI client access from ChatGPT and Claude
  • Bearer token and OAuth authentication
  • Browser Automation
  • Coding assistant integration
  • Desktop application controlmacOS only; Docker cannot control the macOS desktop.
  • External MCP service connections
  • File Management
  • Git operations
  • MCP server (Streamable HTTP)
  • Multi-device orchestration
  • Public access via Cloudflare Tunnel
  • Remote command execution
  • Skills and plugins extensibility
  • Task persistence and recovery

AgentDock README

How to install AgentDock

Install AgentDock with Docker Compose

Docker and Docker Compose installed
Environment variables
AGENTDOCK_AUTH_TOKEN, AGENTDOCK_IMAGE, AGENTDOCK_SERVER_URL, AGENTDOCK_BROWSER_ENABLED, AGENTDOCK_BROWSER_CDP_URL, AGENTDOCK_PUBLISH_HOST, AGENTDOCK_PUBLISH_PORT, TUNNEL_TOKEN
mkdir -p agentdock && cd agentdock
curl -fL https://raw.githubusercontent.com/uvwt/agentdock/main/docker-compose.yml \
  -o docker-compose.yml
printf 'AGENTDOCK_AUTH_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env

Then start and verify:

docker compose up -d
docker compose ps

Official prebuilt image; optional Cloudflare quick/named tunnel profiles in the same Compose file. Docker cannot control the macOS desktop.

How to configure AgentDock

  • AGENTDOCK_ACP_DEFAULT_PROFILEChoose the default Coding Agent profile.

    Choose the default Coding Agent profile.

  • AGENTDOCK_ACP_ENABLEDEnable Coding Agent tools.

    Enable Coding Agent tools.

    values: true, false

  • AGENTDOCK_ACP_INTERACTION_TIMEOUT_MSSet the Coding Agent interaction timeout in milliseconds.

    Set the Coding Agent interaction timeout in milliseconds.

  • AGENTDOCK_ACP_MAX_CONCURRENT_PROMPTSLimit concurrent Coding Agent prompts.

    Limit concurrent Coding Agent prompts.

  • AGENTDOCK_ACP_PROFILES_JSONConfigure available Coding Agent profiles.

    Configure available Coding Agent profiles.

  • AGENTDOCK_AUTH_TOKENAgentDock's own Bearer-token authentication secret; required for public tunnel access.

    AgentDock's own Bearer-token authentication secret; required for public tunnel access.

    values: random secret

  • AGENTDOCK_BROWSER_CDP_URLConnect to a configured CDP endpoint (CLI flag --browser-cdp-url).

    Connect to a configured CDP endpoint (CLI flag --browser-cdp-url).

  • AGENTDOCK_BROWSER_ENABLEDfalseEnable browser tools (CLI flag --browser-enabled).

    Enable browser tools (CLI flag --browser-enabled).

    values: true, false

  • AGENTDOCK_BROWSER_EXECUTABLE_PATHUse a specific Chrome, Chromium, or Edge executable (CLI flag --browser-executable-path).

    Use a specific Chrome, Chromium, or Edge executable (CLI flag --browser-executable-path).

  • AGENTDOCK_BROWSER_REUSE_EXISTING_CDPfalsePrefer a reusable local CDP browser (CLI flag --browser-reuse-existing-cdp).

    Prefer a reusable local CDP browser (CLI flag --browser-reuse-existing-cdp).

    values: true, false

  • AGENTDOCK_DEFAULT_DIR~/AgentDockDefault working directory for relative file operations.

    Default working directory for relative file operations.

  • AGENTDOCK_HOME~/.agentdockState directory.

    State directory.

  • AGENTDOCK_HOST127.0.0.1Listen address (CLI flag --host).

    Listen address (CLI flag --host).

  • AGENTDOCK_IMAGEghcr.io/uvwt/agentdock:latestContainer image used by the official Compose file; switch to the browser tag for the Chromium-included image.

    Container image used by the official Compose file; switch to the browser tag for the Chromium-included image.

  • AGENTDOCK_LOG_LEVELinfoLog level (CLI flag --log-level).

    Log level (CLI flag --log-level).

  • AGENTDOCK_MCP_APPS_MODEfullChat cards mode (CLI flag --mcp-apps-mode).

    Chat cards mode (CLI flag --mcp-apps-mode).

    values: full, compact, off

  • AGENTDOCK_OAUTH_ACCESS_TOKEN_TTLOptional access-token lifetime.

    Optional access-token lifetime.

  • AGENTDOCK_OAUTH_ENABLEDEnable OAuth.

    Enable OAuth.

    values: true, false

  • AGENTDOCK_OAUTH_PASSWORDPassword used on the OAuth authorization page.

    Password used on the OAuth authorization page.

  • AGENTDOCK_OAUTH_TOKEN_SECRETSigning secret for OAuth state and tokens.

    Signing secret for OAuth state and tokens.

  • AGENTDOCK_PORT8765Port the server listens on (CLI flag --port).

    Port the server listens on (CLI flag --port).

  • AGENTDOCK_PUBLISH_HOST127.0.0.1Host interface the Compose port mapping binds to.

    Host interface the Compose port mapping binds to.

  • AGENTDOCK_PUBLISH_PORT8765Optional host-side published port in the Compose file.

    Optional host-side published port in the Compose file.

  • AGENTDOCK_SERVER_URLPublic HTTPS origin (without /mcp); used with the named Cloudflare Tunnel, empty for quick tunnel.

    Public HTTPS origin (without /mcp); used with the named Cloudflare Tunnel, empty for quick tunnel.

    values: https URL

  • AGENTDOCK_STDIOfalseEnable the stdio MCP transport (CLI flag --stdio).

    Enable the stdio MCP transport (CLI flag --stdio).

    values: true, false

  • AGENTDOCK_TRUSTED_PROXY_CIDRSTrusted proxy CIDRs.

    Trusted proxy CIDRs.

    values: CIDR list

  • TUNNEL_TOKENCloudflare Tunnel token, only needed for the Named Tunnel profile.

    Cloudflare Tunnel token, only needed for the Named Tunnel profile.

AgentDock releases & version history

More in Remote Access

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…