Docker er den samme AgentX-daemon som Linux-pakkerne — systemtilstand i en kasse. Én container, én tilmelding, mange agenter indeni. Virker på Mac, Windows og Linux med Docker Desktop eller Docker Engine. Dit arbejde bliver på de volumener, du monterer. Hub-imaget indeholder daemonen og AgentX CLI; ved første start henter den Claude Code, Codex og Grok CLI ned i data-voluminet (kræver netværk — vi videredistribuerer ikke de binære filer i imaget).
/var/lib/agentx/tools første gang den kører (og genbruger dem ved senere starter). Spring over med
-e AGENTX_SKIP_CLI_INSTALL=1 hvis du medbringer dine egne. Modelnøgler forbliver dine.linux/amd64. På Apple Silicon kan Docker Desktop køre det image via emulering; et oprindeligt
arm64 multi-arch-image er planlagt.Containeren er altid Linux. På Mac og Windows kører Docker Desktop det Linux-image for dig. Kommandoerne nedenfor henter agentxhq/agentx-daemon:latest til en første prøve på standardkonsolporten. Lås et versionsmærke, når du vil have en fast version.
Installer Docker Desktop til Mac, start den, og vent til motoren kører. Dagens Hub-image er
linux/amd64 — Intel-Macs kører det oprindeligt; Apple Silicon kører det gennem Dockers emulering, indtil vi udgiver multi-arch.
docker pull agentxhq/agentx-daemon:latestdocker 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:latestTre navngivne volumener: daemon-database, root-hjem (agent-workspaces) og
/home til Unix-brugere, du tilføjer senere.
open http://127.0.0.1:3333/consoleEller åbn http://127.0.0.1:3333/console i browseren. Log: docker logs -f agentx.
Installer Docker Desktop til Windows med WSL 2-backend slået til. Brug PowerShell eller Windows Terminal, når Docker melder, at den kører.
docker pull agentxhq/agentx-daemon:latestdocker 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:latestBackticks er linjefortsættelser i PowerShell. I cmd.exe bruger du én linje, eller
^ som fortsættelse.
start http://127.0.0.1:3333/consoleEller gå til http://127.0.0.1:3333/console.
Log: docker logs -f agentx.
Installer Docker Engine til din distribution (fra Dockers dokumentation, eller Docker Desktop på en arbejdsstation. Din bruger skal kunne tale med Docker-socketten (ofte medlemskab af gruppen
docker ).
docker pull agentxhq/agentx-daemon:latestdocker 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:latestForetrækker du en oprindelig pakkeinstallation på bare-metal-servere? Brug de oprindelige Linux-pakker i stedet.
xdg-open http://127.0.0.1:3333/consoleEller åbn http://127.0.0.1:3333/console.
Sundhed: curl -sS http://127.0.0.1:3333/readyz.
3333, så sæt
-e AGENTX_SURFACES_WEB_PUBLIC_URL_OVERRIDE=http://127.0.0.1:<port>
så claim-omdirigeringer vender tilbage til den URL, du faktisk åbner.:3334 blive inde i containeren — MCP og CLI'en taler kun med daemonen på containernetværket.Imaget kører som root inde i containeren — det er bevidst flerbrugertilstand, det samme som agentx-server på bart metal. Root i containeren er ikke root på din bærbare, medmindre du eskalerer Docker selv.
SQLite, identitet, tilmelding. Navngivet volumen agentx-data. Overlever genskabelse af containeren.
Agenter, der kører som root, bruger /root/.agentx/<Name>. CLI-auth-filer ligger under /root også. Volumen agentx-root.
Hjem til brugere, du opretter til run_as. Volumen agentx-home.
Vælgeren til opret-agent lister Unix-konti inde i containeren, der har en rigtig login-shell og et hjemmekatalog. Opret brugere med useradd; de lander på voluminet
/home og overlever image-opgraderinger.
docker exec -it agentx useradd -m -s /bin/bash alice
docker exec -it agentx id aliceOpret derefter en agent i konsollen, og sæt Kør som til alice. Workspace ligger som standard under
/home/alice/.agentx/<AgentName>.
docker exec agentx getent passwd | cut -d: -f1,6,7Konti med shells som nologin eller false udelades fra vælgeren.
agentx-daemon og agentx (plus hjælpere). Leverandørernes agent-CLI'er hentes ved første start ned i
/var/lib/agentx/tools på data-voluminet — de er ikke bagt ind i Hub-lagene.docker volume rm agentx-data agentx-root agentx-home.docker pull agentxhq/agentx-daemon:latest
docker rm -f agentx
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:latestGenbrug de samme volumenavne, så tilmelding og workspaces kommer tilbage. For at låse en version fast, erstat :latest med et versionsmærke fra
Hub-taglisten.
docker rm -f agentxVolumener bliver, indtil du sletter dem eksplicit.