One image with the full feature set, including browser automation. It runs the same runtime your desktop app runs.

The image

Get AGNT running with full browser automation in under 5 minutes.

What You Get

✅ Complete web application (browser-based UI)
✅ Browser automation (Puppeteer/Playwright)
✅ Multi-device access
✅ Supports 2-10 concurrent users
📦 Image size: ~1.5GB
🌐 Port: 3333

Prerequisites

Docker 20.10+ or Docker Desktop (any OS: Windows, macOS, GNU/Linux, FreeBSD, etc.)
2GB free RAM
2GB free disk space

Installation

Option 1: Pull from GHCR (Recommended - Fastest)

# Run container with pre-built image
docker run -d \
  --name agnt-full \
  -p 3333:3333 \
  -v agnt-data:/app/data \
  -e NODE_ENV=production \
  -e BASE_URL=http://localhost:3333 \
  --restart unless-stopped \
  ghcr.io/agnt-gg/agnt:latest

Using specific version:

docker run -d \
  --name agnt-full \
  -p 3333:3333 \
  -v agnt-data:/app/data \
  -e NODE_ENV=production \
  -e BASE_URL=http://localhost:3333 \
  --restart unless-stopped \
  ghcr.io/agnt-gg/agnt:0.6.6

Option 2: Docker Compose with GHCR

Create docker-compose.yml:

version: '3.8'

services:
  agnt-full:
    image: ghcr.io/agnt-gg/agnt:latest
    container_name: agnt-full
    ports:
      - "3333:3333"
    environment:
      - NODE_ENV=production
      - BASE_URL=http://localhost:3333
    volumes:
      - agnt-data:/app/data
    restart: unless-stopped

volumes:
  agnt-data:

Start the service:

docker-compose up -d

Option 3: Build from Source (Advanced)

# Clone repository
git clone https://github.com/agnt-gg/agnt.git
cd agnt

# Start Docker Full
make run-full

# Or use docker-compose directly
docker-compose up -d

Access AGNT

Open your browser to:

http://localhost:3333

From other devices on your network:

http://YOUR_SERVER_IP:3333

Verify Installation

# Check container status
docker ps | grep agnt

# View logs
docker logs agnt -f

Healthy status should show:

STATUS: Up X seconds (healthy)

First Steps

Open web UI: http://localhost:3333
Configure AI provider: Add your OpenAI/Anthropic/Google API key
Create first agent: Click "New Agent" and configure
Test chat: Send a message to your agent
Explore workflows: Create automated workflows

Common Commands

# Stop AGNT
docker stop agnt

# Start AGNT
docker start agnt

# View logs
docker logs agnt -f

# Restart AGNT
docker restart agnt

# Remove AGNT (keeps data)
docker rm agnt

# Update to latest version
docker pull ghcr.io/agnt-gg/agnt:latest
docker stop agnt
docker rm agnt
# Re-run docker run command above

Data Location

All data stored in:

Database: ~/.agnt/data/agnt.db
Plugins: ~/.agnt/plugins/installed/
Logs: ~/.agnt/logs/

Features Available

✅ All AI agents and workflows
✅ All API integrations (OpenAI, Anthropic, Google, etc.)
✅ Plugin system
✅ Web scraping with Puppeteer
✅ Browser automation with Playwright
✅ Screenshot capture
✅ Image processing
✅ Email automation
✅ MCP server support

Troubleshooting

Port 3333 already in use

Change port in docker run command:

-p 3334:3333  # Use port 3334 instead

Container won't start

Check logs:

docker logs agnt

Can't access from other devices

Ensure firewall allows port 3333:

# Ubuntu/Debian
sudo ufw allow 3333

# Check if port is open
netstat -tlnp | grep 3333

Next Steps

README - Learn how to use AGNT
Plugin Development - Create custom plugins
API Documentation - REST API reference

Support

Issues: GitHub Issues
Discord: Join community
Documentation: Full docs

Run AGNT with Docker