INSTALL GUIDE • AGENT ZERO

Install Agent Zero with Docker prerequisite checks on every OS

Official quick-start commands plus beginner troubleshooting.

PREREQUISITE

Install Docker first

Windows and macOS users can open Docker Desktop download, install it, then wait until Docker Desktop reports running. Linux users should install Docker Engine from distro documentation.

docker --version

Expected result: Docker version prints.

If this fails, do this: Restart machine after Docker install and run version command again.
WINDOWS

Run Agent Zero container

docker pull agent0ai/agent-zero
docker run -p 50001:80 agent0ai/agent-zero

Open browser to http://localhost:50001.

Expected result: Agent Zero web UI opens.

If this fails, do this: Run docker ps. If no container is running, run docker run again. If port is busy, use docker run -p 50002:80 agent0ai/agent-zero and open port 50002.
POST-INSTALL CHECK

Verification

docker ps
docker images

Expected result: You see running container and downloaded image.

NEXT

Agent Zero usage guide

After install, complete the use guide for real day-to-day tasks.

Open usage guide →