Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Self-host Agent Zero
updated Nov 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
A general-purpose AI agent that works inside its own Linux environment in a Docker container, driven from a web interface. The agent can run terminal commands and code, browse the web with a built-in browser you can annotate, use a Linux desktop and LibreOffice documents shown in a canvas beside the chat, delegate work to sub-agents, and keep projects, memory and skills in a persistent user folder. Providers, tools and integrations are added as plugins from a Plugin Hub. It needs a provider API key, a supported AI account or a local model server before it can answer.
Pick Agent Zero when you want one general-purpose agent that works in a real Linux environment of its own rather than a workflow you draw: it runs terminal commands and code, browses with a built-in browser you can annotate, drives a Linux desktop and LibreOffice documents in a canvas beside the chat, delegates to sub-agents, and keeps projects, memory and skills in one user folder. It is MIT-licensed (the repository's licence file is the MIT text, although the GitHub badge reads NOASSERTION), Python with Flask, and ships as one image. Our snippet adapts the project's compose file and VPS guide, pins `agent0ai/agent-zero:v2.15` (released 2026-11-01, amd64 and arm64) instead of `latest`, writes a generated `AUTH_PASSWORD` into `.env` and mounts it at `/a0/.env`, and keeps user data in the `a0_usr` volume. The VPS guide gives 2 GB RAM as a minimum and 4 GB or more as recommended; our floor follows the minimum. In the catalog, Dify, Flowise, Langflow and Sim are builders where you assemble agent flows on a canvas, MaxKB is a retrieval and knowledge-base platform, and OpenHands is a coding-only agent; Agent Zero is closer to a general assistant with a computer of its own.
What you need
Any VPS with at least 2048 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Paid link — we earn a commission if you shop through it.
Install
Run these commands on your server:
# Agent Zero — autonomous AI agent with a web UI — pinned to v2.15; adapted from the project's docker/run compose file and VPS guide, with login credentials generated into .envecho "AUTH_LOGIN=admin" > .envecho "AUTH_PASSWORD=$(openssl rand -hex 12)" >> .envcat > docker-compose.yml <<'EOF'services: agent-zero: image: agent0ai/agent-zero:v2.15 restart: unless-stopped ports: - 50080:80 volumes: - ./.env:/a0/.env - a0_usr:/a0/usr ulimits: nofile: soft: 65535 hard: 65535volumes: a0_usr:EOFdocker compose up -dtimeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:50080/login; do sleep 3; done'# → http://SERVER_IP:50080 — a sign-in page; the username is admin and the password is AUTH_PASSWORD in .env (cat .env)
Agent Zero's README, installation guide and VPS guide flag these before you rely on it:
non-negotiableWithout AUTH_LOGIN and AUTH_PASSWORD the web interface has no sign-in. The VPS guide marks authentication as required for web access and warns that AUTH_LOGIN is the username, not a boolean. Our snippet sets both, but the project's own quick start binds to 127.0.0.1 for a reason: put TLS in front of any port you expose.
non-negotiableThe agent runs commands and code with real effects. The README's safety model says to keep it inside Docker or another isolated environment, not to mount your whole home directory, and to review actions that touch accounts, money or production systems. Do not give it credentials in prompts.
non-negotiableIt does nothing useful until you connect a provider API key, a supported AI account or a local model server in the settings; none is bundled. On Linux, a model server running on the host needs extra_hosts: host.docker.internal:host-gateway in the compose file (our snippet omits upstream's mapping) or the Docker gateway address. Utility tasks such as memory summaries use a second model setting, and the docs advise testing a smaller local model there before relying on it.
non-negotiableKeep user data under /a0/usr. For the v1.20 to v2.0 jump specifically, the installation guide cautions against bind-mounting a whole old /a0 directory into the new container; back up /a0/usr (Settings, Check for Updates, Backup & Restore), start the new tag, and restore. If settings fail to load after an upgrade, the guide says to remove /a0/usr/settings.json and restart to regenerate defaults.
non-negotiableThe image is large, about 3.2 GB compressed on amd64. The docs recommend the built-in Self Update (Settings, Update tab), which changes the code inside a running container to another release tag, so the container can drift from the image tag we pin; decide whether you update through the UI or by changing the image, and back up first.
Agent Zero used 1201 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 2048 MB.
Is the Agent Zero install snippet verified?
The Agent Zero install snippet is marked verified on Ubuntu 26.04 (Nov 2026).