Linux

Installing AgentDock on Linux: an experimental AppImage build.

Experimental

Linux support is experimental. AgentDock ships an AppImage build (x64) with no dedicated automated smoke test, and agent-CLI detection on Linux is PATH search only — there's no known-install-directory fallback like on Windows and macOS.

Download

Get the AppImage from GitHub Releases or agdc.dev/downloads, make it executable, and run it:

bash

chmod +x AgentDock-*.AppImage
./AgentDock-*.AppImage

Building from source on Linux

There's no dedicated packaging script for Linux in the free repository. If you need a fresh Linux build:

bash

git clone https://github.com/crossainthero-lab/AgentDock.git
cd AgentDock
npm install
npm run build
npx electron-builder --linux

Sandbox errors

Electron's sandbox has known permission requirements on Linux that can cause AgentDock to fail on launch with a setuid_sandbox_host fatal error. See Linux sandbox issues for the exact error text and how to fix it.

Executable detection

Because Linux detection is PATH-only, make sure claude, codex, or agy are actually on your shell's PATH in the environment AgentDock is launched from. See Agent CLI not detected if AgentDock isn't finding a CLI you know is installed.