Install AgentX on a computer you own, connect it to your account, and run every agent from one screen. About ten minutes.
Help me install AgentX on my own computer or server.
Read https://www.agentxhq.com/install.md and follow it.
When you're done, give me my claim link.
Use a coding agent on the machine where AgentX should run. A web chat like claude.ai can't install software.
Your agent finishes with a link. Open it, and the machine joins your account.
AgentX runs on your own computer and hosts your agents there. Install it, connect it from your console, and it joins your account.
Stable 0.195.1 · published 2026-11-10
Install only one of the two.
Not sure? Apple menu → About This Mac. “Apple M1” or later means Apple Silicon.
Install only one: desktop and server packages conflict. Server runs as root so agents can work across multiple users.
Homebrew and the package without Homebrew run AgentX as the logged-in user, and the agents run as that same user. That install does not run agents as other accounts.
brew install agentxhq/tap/agentx
Installs agentx-daemon, agentx and the agentx-browser symlink. State lives under ~/.agentx/.
agentx-daemon background agentx-daemon status open http://127.0.0.1:3333/console
Or start it at every login with: brew services start agentx
curl -fLO https://app.agentxhq.io/releases/agentx-0.195.1-darwin-arm64.tar.gz
echo "1f1d53b6db453d4e2be60b0aa83022c93edc04ab45c9444aea1c3e668b2858ec agentx-0.195.1-darwin-arm64.tar.gz" | shasum -a 256 -c
Only continue when it prints agentx-0.195.1-darwin-arm64.tar.gz: OK. Anything else means the file is damaged or isn't ours, so don't install it.
tar xzf agentx-0.195.1-darwin-arm64.tar.gz && cd agentx-0.195.1-darwin-arm64 && ./install.sh --launchd
Puts agentx-daemon and agentx in ~/.local/bin (no sudo) and starts AgentX now and at every login.
Downloaded it in a browser instead? Run xattr -dr com.apple.quarantine . in the unpacked folder first. These builds are not yet signed or notarized; Homebrew installs them without a Gatekeeper prompt.
curl -fLO https://app.agentxhq.io/releases/agentx-0.195.1-darwin-amd64.tar.gz
echo "0df5874a26572a729a820baef8e3f2c1038fe066861799ff089498818a9f7454 agentx-0.195.1-darwin-amd64.tar.gz" | shasum -a 256 -c
Only continue when it prints agentx-0.195.1-darwin-amd64.tar.gz: OK. Anything else means the file is damaged or isn't ours, so don't install it.
tar xzf agentx-0.195.1-darwin-amd64.tar.gz && cd agentx-0.195.1-darwin-amd64 && ./install.sh --launchd
Puts agentx-daemon and agentx in ~/.local/bin (no sudo) and starts AgentX now and at every login.
Downloaded it in a browser instead? Run xattr -dr com.apple.quarantine . in the unpacked folder first. These builds are not yet signed or notarized; Homebrew installs them without a Gatekeeper prompt.
Install Docker Desktop for Mac. Open the Terminal app once Docker reports running.
docker pull --platform linux/amd64 agentxhq/agentx-daemon:latest
docker run -d --platform linux/amd64 --name agentx --restart unless-stopped \ -p 127.0.0.1:3333:3333 \ -v agentx-data:/var/lib/agentx \ -v agentx-root:/root \ -v agentx-home:/home \ agentxhq/agentx-daemon:latest
This pins nothing yet. To use a fixed version, replace :latest with a tag from Docker Hub.
Using a port other than 3333? Add -e AGENTX_SURFACES_WEB_PUBLIC_URL_OVERRIDE=http://127.0.0.1:<port> so the claim link sends you back to the right address.
open http://127.0.0.1:3333/console
Or browse to http://127.0.0.1:3333/console. To watch the logs: docker logs -f agentx
For the computer you sign in to. It installs for you alone, with no administrator prompt. AgentX runs as you while you are signed in, and your agents use your own Claude and other CLI logins. The installer is signed by My Server Guy ApS.
curl.exe -fLO https://app.agentxhq.io/releases/agentx-desktop_0.195.1_amd64.msi (Get-FileHash .\agentx-desktop_0.195.1_amd64.msi -Algorithm SHA256).Hash -eq 'ce9472f47e8f9d8d99f8797ad64d80fcbf07c84d8be1abcb3a31825fe100dda1'
Only continue when it prints True. Anything else means the file is damaged or isn't ours, so don't install it.
msiexec /i "$PWD\agentx-desktop_0.195.1_amd64.msi" /l*v agentx-install.log
Or double-click the file. When it finishes, AgentX starts and your browser opens its claim page. AgentX starts again each time you sign in.
Your browser opens the claim page. If it didn't, follow the steps below.
To upgrade, download the newer installer and run it the same way. AgentX keeps its connection to your account, your agents and their files.
To remove AgentX, uninstall AgentX in Settings › Apps. Your AgentX files stay in %USERPROFILE%\.agentx.
For a computer that is always on. It installs for the whole computer, with one administrator prompt. AgentX runs as a Windows service, keeps running when nobody is signed in, and runs each agent as its own Windows user. The installer is signed by My Server Guy ApS.
curl.exe -fLO https://app.agentxhq.io/releases/agentx-server_0.195.1_amd64.msi (Get-FileHash .\agentx-server_0.195.1_amd64.msi -Algorithm SHA256).Hash -eq 'e546a3ddb15e1d7f1a9c70b47631977b553346abe8ed06180ddd3cd791e813f3'
Only continue when it prints True. Anything else means the file is damaged or isn't ours, so don't install it.
msiexec /i "$PWD\agentx-server_0.195.1_amd64.msi" /l*v agentx-install.log
Or double-click the file and accept the administrator prompt. When it finishes, the AgentX service is running and starts with Windows, and your browser opens its claim page.
Your browser opens the claim page. If it didn't, follow the steps below.
(Get-Content C:\ProgramData\AgentX\router-state.json | ConvertFrom-Json).claim_url
To upgrade, download the newer installer and run it the same way. AgentX keeps its connection to your account, your agents and their files.
To remove AgentX, uninstall AgentX Server in Settings › Apps. That also removes the AgentX service. Your AgentX files stay in C:\ProgramData\AgentX.
Install Docker Desktop for Windows with the WSL 2 backend enabled. Use PowerShell or Windows Terminal once Docker reports running.
docker pull --platform linux/amd64 agentxhq/agentx-daemon:latest
docker run -d --platform linux/amd64 --name agentx --restart unless-stopped ` -p 127.0.0.1:3333:3333 ` -v agentx-data:/var/lib/agentx ` -v agentx-root:/root ` -v agentx-home:/home ` agentxhq/agentx-daemon:latest
The backticks continue the line in PowerShell. In cmd.exe, put it on one line or use ^ instead.
Using a port other than 3333? Add -e AGENTX_SURFACES_WEB_PUBLIC_URL_OVERRIDE=http://127.0.0.1:<port> so the claim link sends you back to the right address.
start http://127.0.0.1:3333/console
Or browse to http://127.0.0.1:3333/console. To watch the logs: docker logs -f agentx
wget https://app.agentxhq.io/releases/agentx-desktop_0.195.1_amd64.deb
echo "7f40062f4b577d7c13f915c070b038d4b7898d008b3bcb601bd5fc9a6a755feb agentx-desktop_0.195.1_amd64.deb" | sha256sum --check
Only continue when it prints agentx-desktop_0.195.1_amd64.deb: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo apt install ./agentx-desktop_0.195.1_amd64.deb
apt resolves dependencies and sets up the desktop service, which keeps running after you log out. For a pure root install, set AGENTX_DESKTOP_USER=yourlogin before apt.
wget https://app.agentxhq.io/releases/agentx-desktop_0.195.1_arm64.deb
echo "3a01fece3dc9ebf62307e9eda96edb8319419b6a3c5b2c9eeb01fc00c1ffbe3a agentx-desktop_0.195.1_arm64.deb" | sha256sum --check
Only continue when it prints agentx-desktop_0.195.1_arm64.deb: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo apt install ./agentx-desktop_0.195.1_arm64.deb
apt resolves dependencies and sets up the desktop service, which keeps running after you log out. For a pure root install, set AGENTX_DESKTOP_USER=yourlogin before apt.
wget https://app.agentxhq.io/releases/agentx-server_0.195.1_amd64.deb
echo "9510fb950d3171d855c5faf22235a01008e248fc38ae8cf6bebcae3f8cbd8c5c agentx-server_0.195.1_amd64.deb" | sha256sum --check
Only continue when it prints agentx-server_0.195.1_amd64.deb: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo apt install ./agentx-server_0.195.1_amd64.deb
apt resolves the package's dependencies and installs AgentX.
wget https://app.agentxhq.io/releases/agentx-server_0.195.1_arm64.deb
echo "486645ef37044f0a9357a9c044bb0e5f62e8e79d897e4d32c1cf6233b307589f agentx-server_0.195.1_arm64.deb" | sha256sum --check
Only continue when it prints agentx-server_0.195.1_arm64.deb: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo apt install ./agentx-server_0.195.1_arm64.deb
apt resolves the package's dependencies and installs AgentX.
wget https://app.agentxhq.io/releases/agentx-desktop-0.195.1-1-x86_64.pkg.tar.zst
echo "efb75cd2ed36e1bc683fcd37067a81ab132596a739d0f16b81bce2614f68f64e agentx-desktop-0.195.1-1-x86_64.pkg.tar.zst" | sha256sum --check
Only continue when it prints agentx-desktop-0.195.1-1-x86_64.pkg.tar.zst: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo AGENTX_DESKTOP_USER="$USER" pacman -U ./agentx-desktop-0.195.1-1-x86_64.pkg.tar.zst
Sets the desktop user explicitly (pacman as root often has an empty SUDO_USER), then installs and enables the user service.
wget https://app.agentxhq.io/releases/agentx-desktop-0.195.1-1-aarch64.pkg.tar.zst
echo "c08d889f0bea52a9447f31d7f7f35b6a97a473be539154df604b845c58556843 agentx-desktop-0.195.1-1-aarch64.pkg.tar.zst" | sha256sum --check
Only continue when it prints agentx-desktop-0.195.1-1-aarch64.pkg.tar.zst: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo AGENTX_DESKTOP_USER="$USER" pacman -U ./agentx-desktop-0.195.1-1-aarch64.pkg.tar.zst
Sets the desktop user explicitly (pacman as root often has an empty SUDO_USER), then installs and enables the user service.
wget https://app.agentxhq.io/releases/agentx-server-0.195.1-1-x86_64.pkg.tar.zst
echo "25ffd24d35b9ef3a41e82d14bf6f12c412b47d999353141a8a94a4756fef827f agentx-server-0.195.1-1-x86_64.pkg.tar.zst" | sha256sum --check
Only continue when it prints agentx-server-0.195.1-1-x86_64.pkg.tar.zst: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo pacman -U ./agentx-server-0.195.1-1-x86_64.pkg.tar.zst
Installs the package and enables the matching systemd service.
wget https://app.agentxhq.io/releases/agentx-server-0.195.1-1-aarch64.pkg.tar.zst
echo "4712f6509d9cff8fec14ebf5823108a6ede24d8e175dbdd03854c11705430815 agentx-server-0.195.1-1-aarch64.pkg.tar.zst" | sha256sum --check
Only continue when it prints agentx-server-0.195.1-1-aarch64.pkg.tar.zst: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo pacman -U ./agentx-server-0.195.1-1-aarch64.pkg.tar.zst
Installs the package and enables the matching systemd service.
wget https://app.agentxhq.io/releases/agentx-desktop-0.195.1-1.x86_64.rpm
echo "400cdcdac4fb40000bab29546d356770a6f1ca31e57ea6d70ce8474b89899c0e agentx-desktop-0.195.1-1.x86_64.rpm" | sha256sum --check
Only continue when it prints agentx-desktop-0.195.1-1.x86_64.rpm: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo dnf install ./agentx-desktop-0.195.1-1.x86_64.rpm
wget https://app.agentxhq.io/releases/agentx-desktop-0.195.1-1.aarch64.rpm
echo "439efd7fa99ab7fb83350fcd37280dee94f1807d6c0291dd7f2467fec0a8702c agentx-desktop-0.195.1-1.aarch64.rpm" | sha256sum --check
Only continue when it prints agentx-desktop-0.195.1-1.aarch64.rpm: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo dnf install ./agentx-desktop-0.195.1-1.aarch64.rpm
wget https://app.agentxhq.io/releases/agentx-server-0.195.1-1.x86_64.rpm
echo "04cfb878ed968b2a5de92cbd13e70c2cf1f6edb81ff68d573a143568976da79a agentx-server-0.195.1-1.x86_64.rpm" | sha256sum --check
Only continue when it prints agentx-server-0.195.1-1.x86_64.rpm: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo dnf install ./agentx-server-0.195.1-1.x86_64.rpm
wget https://app.agentxhq.io/releases/agentx-server-0.195.1-1.aarch64.rpm
echo "b546dc80845540064d0c0f125dc2ed878b264538560e6e78390f1b9c00f404da agentx-server-0.195.1-1.aarch64.rpm" | sha256sum --check
Only continue when it prints agentx-server-0.195.1-1.aarch64.rpm: OK. Anything else means the file is damaged or isn't ours, so don't install it.
sudo dnf install ./agentx-server-0.195.1-1.aarch64.rpm
No package is available for this OS / distro / flavor / architecture combination in the current release feed. Try another selection, or check back after the next publish.
Install Docker Engine. Your user needs permission to pull images and publish a local port.
docker pull agentxhq/agentx-daemon:latest
This command is for linux/amd64. On Linux arm64, docker pull --platform linux/arm64 agentxhq/agentx-daemon:latest fails because there is no linux/arm64 image. Use the native package: native Linux packages.
docker run -d --name agentx --restart unless-stopped \ -p 127.0.0.1:3333:3333 \ -v agentx-data:/var/lib/agentx \ -v agentx-root:/root \ -v agentx-home:/home \ agentxhq/agentx-daemon:latest
This pins nothing yet. To use a fixed version, replace :latest with a tag from Docker Hub.
Using a port other than 3333? Add -e AGENTX_SURFACES_WEB_PUBLIC_URL_OVERRIDE=http://127.0.0.1:<port> so the claim link sends you back to the right address.
xdg-open http://127.0.0.1:3333/console
Or browse to http://127.0.0.1:3333/console. To watch the logs: docker logs -f agentx
The image runs as root inside the container, the same multi-user mode as agentx-server. Root in the container is not root on your computer unless you give Docker itself more rights.
When you create an agent, the picker lists accounts in the container that have a real login shell and a home folder. Create one like this, then set Run as to that user. Its workspace defaults to /home/alice/.agentx/<AgentName>.
docker exec -it agentx useradd -m -s /bin/bash alice docker exec -it agentx id alice
docker exec agentx getent passwd | cut -d: -f1,6,7
Accounts with shells like nologin or false are left out of the picker. Each user keeps their own CLI logins in their home folder.
docker pull --platform linux/amd64 agentxhq/agentx-daemon:latest && docker rm -f agentx && docker run -d --platform linux/amd64 --name agentx --restart unless-stopped -p 127.0.0.1:3333:3333 -v agentx-data:/var/lib/agentx -v agentx-root:/root -v agentx-home:/home agentxhq/agentx-daemon:latest
Reusing the same volume names brings your enrollment and workspaces back. To pin a build, replace :latest with a version tag from Docker Hub.
docker exec agentx useradd --create-home --home-dir /home/<account> --shell /bin/bash <account> docker exec agentx chown -R <account>: /home/<account>
A new container does not keep Unix accounts of agents that have their own user. Run this again for each such account. The home is already on the agentx-home volume.
docker rm -f agentx
Volumes remain until you delete them yourself.
docker rm -f agentx docker volume rm agentx-data agentx-root agentx-home
This removes enrollment, workspaces and CLI logins. You will need to connect the computer again.
Linux packages and Docker start AgentX automatically. On Windows, AgentX starts when the installer finishes. On Mac with Homebrew, run agentx-daemon background if it isn't running yet. Then claim it so it joins your account:
Leave port 3334 unpublished. AgentX uses it inside the container only; nothing outside needs it.
A deployment token is a reusable enrollment key you create in Settings. With one, you can enroll with the token install command instead of the interactive claim link. Same end state, no clicking per machine.
Once the computer is connected, your agents, sessions and artifacts are live in the console. Create named agents, put them in a chat, and set them to work. https://www.agentxhq.com/console