Files
fleet-ops/README.md
Alexander Whitestone c92d986a67 Add Docker Compose fleet config for agent containerization (closes #5)
- docker-compose.yml: Ollama, Gitea, Agent worker, Monitor services
- Dockerfile.agent: Hermes agent worker image with health endpoint
- .env.example: Environment variable template
- README.md: Setup instructions and service documentation

Services include health checks, persistent volumes, isolated network,
and proper dependency ordering.
2026-04-10 07:15:14 -04:00

49 lines
1.5 KiB
Markdown

# fleet-ops
Sovereign Fleet Operations: Ansible playbooks and infrastructure-as-code for the Wizard fleet.
## Quick Start (Docker Compose)
### Prerequisites
- Docker and Docker Compose v2 installed
- (Optional) NVIDIA GPU + nvidia-container-toolkit for GPU-accelerated inference
### Setup
```bash
# Clone and enter the repo
git clone <repo-url> && cd fleet-ops
# Copy the env template and edit it
cp .env.example .env
# Edit .env with your actual values (API keys, ports, agent name, etc.)
# Start all services
docker compose up -d
# View logs
docker compose logs -f agent
# Stop everything
docker compose down
```
### Services
| Service | Description | Default Port |
|-----------|-----------------------------------|--------------|
| `ollama` | Local LLM inference engine | 11434 |
| `gitea` | Forge (git hosting, issue tracker)| 3000, 2222 |
| `agent` | Hermes agent worker loop | 8080 |
| `monitor` | Health check reporter | (internal) |
### Customization
- Edit `.env` to change ports, agent name, loop interval, and log level.
- Edit `docker-compose.yml` to add/remove services or adjust resource limits.
- Place agent source code in an `agent/` directory before building.
### Files
- `docker-compose.yml` — Main compose configuration
- `Dockerfile.agent` — Agent worker image
- `.env.example` — Environment variable template
- `playbooks/` — Ansible playbooks for VPS baseline configuration