🔧 Cloud Tools — Dockflare Agents (Gaius & Starbuck)
Host: Cloud – Both VPS nodes · Composes:
Cloud/Gaius/tools/compose.yamlandCloud/Starbuck/tools/compose.yaml
1. Overview
Lightweight Dockflare Agent stacks deployed on both cloud VPS nodes. Each agent watches the local Docker socket (via a secure proxy) and reports container label events back to the main DockFlare instance on the homelab. The Starbuck agent also manages a Cloudflare Tunnel route for SSH access to the dev box.
2. Architecture & Services
| Service | Image | Host | Role |
|---|---|---|---|
docker-socket-proxy |
tecnativa/docker-socket-proxy:v0.4.2 |
Both | Secure Docker socket proxy for the agent |
dockflare-agent |
alplat/dockflare-agent |
Both | Reports Docker label events to central DockFlare |
Starbuck only:
- Manages tunnel route dev.micky.id.au → ssh://192.168.10.101:22 (SSH access to dev box, protected by rem-access group)
3. Networking
dockflare-internal— Bridge network for agent ↔ socket-proxy.cloudflare-net— Agent connects to Cloudflare Tunnel via this network.
4. Persistent Storage
| Container | Volume | Description |
|---|---|---|
dockflare-agent |
dockflare_agent_data (named) |
Agent state and registration |
5. Environment Variables
Loaded from .env:
| Variable | Description |
|---|---|
DOCKFLARE_SERVER_URL |
URL of the central DockFlare instance |
DOCKFLARE_API_KEY |
Authentication key |
6. Access & Usage
These are headless agents — no web UI. Verify via the DockFlare web UI at https://dockflare.m1ckyb.com.
# Gaius
docker compose -f Cloud/Gaius/tools/compose.yaml up -d
# Starbuck
docker compose -f Cloud/Starbuck/tools/compose.yaml up -d