Support
AgentsDock Support
AgentsDock is a self-hosted workspace for Claude Code and Codex. The app on your Mac, iPhone, or iPad is the control surface; the work runs on an AgentsDock server you install on a machine you own. Below is how to get set up, fix the most common problems, and reach us.
Contact us
The fastest way to get help — and to reach the team and other users directly — is our Discord:
- Discord — Join the AgentsDock Discord to ask questions, report bugs, and hear about releases.
When reporting a problem, it helps to include your app version, your device and OS version, and whether the server is reachable from a browser.
System requirements
- iPhone and iPad: iOS / iPadOS 17 or later.
- Mac: macOS 14 or later, Apple silicon.
- Linux: x86_64, distributed as an AppImage.
- Server: a macOS or Linux machine you control, with
tmuxinstalled and the Claude Code and/or Codex CLI authenticated.
Getting started
The app needs a server to talk to. Install one on any machine you own:
- Clone the server repository and run its installer:
git clone https://github.com/ZhengyiLuo/AgentsServer.git, thencd AgentsServerand./install.sh. - The server listens on port
7850. Sign the Claude Code and Codex CLIs in on that machine. - Open the app and connect to the server with its address and access token.
For the full walkthrough — including Tailscale — see the Quick setup guide.
Troubleshooting
The app can't connect to my server
Confirm the server is running and reachable by opening the same URL in a browser on the same device. Check that you included the port, that the device is on the same network (or the same Tailscale network), and that any firewall allows the connection. A URL that works on your desktop will not work on your phone unless both can route to that address.
It says my access token is invalid
When server authentication is enabled, the same token is required for API calls, uploads, live traces, and file previews. On the Mac app the token is shown in the right inspector under Security; on iPhone and iPad it is in the sidebar server card. Copy it exactly, with no surrounding whitespace.
My terminal session disappeared
Each chat owns a persistent tmux session on your server. Disconnecting the app detaches the client but leaves shells and long-running processes alive, so reopening the Terminal tab should reattach. If the tab will not open, verify tmux is installed on the server. Note that closing the final terminal tab intentionally ends that chat's tmux session.
An agent isn't responding
AgentsDock runs the Claude Code and Codex CLIs on your server using your own credentials. Confirm the relevant CLI is installed and authenticated on the server, and that the account has remaining quota with the model provider. AgentsDock does not proxy model requests, so provider-side errors surface directly in the chat.
Media or files won't preview
File and video previews are fetched from your server and require the same access token as the rest of the API. If previews fail while chat works, re-enter the token and confirm the server has enough free disk space.
Privacy and data
Your chats, code, files, and credentials stay on the server you operate. For details on what the apps do and do not collect, see our Privacy Policy.
Docs and community
Full setup instructions, release notes, and architecture documentation live in the AgentsServer repository, and the community is on Discord.