Self-Hosting
Deploy Agents Machine on your own server with Docker.
Agents Machine is designed to be self-hosted — your data stays on your servers. The platform runs as Docker containers with minimal infrastructure requirements.
Architecture
┌──────────────────────────────────────────┐
│ Your Server (VPS) │
│ │
│ ┌──────────────┐ ┌──────────────────┐ │
│ │ MCP Server │ │ Desktop App │ │
│ │ (Bun) │ │ (connects via │ │
│ │ │ │ API) │ │
│ └──────┬───────┘ └──────────────────┘ │
│ │ │
│ ┌──────┴───────┐ ┌──────────────────┐ │
│ │ Qdrant │ │ MinIO (S3) │ │
│ │ (Vectors) │ │ (File storage) │ │
│ └──────────────┘ └──────────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────────┐ │
│ │ PostgreSQL │ │ Redis │ │
│ │ (Metadata) │ │ (Sessions) │ │
│ └──────────────┘ └──────────────────┘ │
└──────────────────────────────────────────┘Requirements
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 2 cores | 4 cores |
| RAM | 4 GB | 8 GB |
| Disk | 20 GB SSD | 50 GB SSD |
| OS | Ubuntu 20.04+ | Ubuntu 22.04 |
| Docker | 20.10+ | Latest |
| Docker Compose | v2.0+ | Latest |
Quick Deploy
Clone the Repository
git clone https://github.com/agents-machine/agents-machine.git
cd agents-machineConfigure Environment
cp .env.example .envEdit .env with your settings:
# LLM Provider
ANTHROPIC_API_KEY=sk-ant-...
# Qdrant
QDRANT_URL=http://qdrant:6333
# Database
DATABASE_URL=postgresql://agents:agents@postgres:5432/agents_machineVerify
docker compose ps
curl http://localhost:6333/healthProduction Deployment
Updating
GitLab CI (Recommended)
Push to main branch triggers automatic deployment via the CI pipeline.
Manual Update
git pull origin main
docker compose down
docker compose up -d --buildMonitoring
🩺 Health Checks
docker compose ps — shows health status of all services.
📜 Logs
docker compose logs -f — stream all logs, or add a service name for
specific logs.
📊 Resources
docker stats — real-time CPU, memory, and network usage per container.