๐ง 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 | Port | Role |
|---|---|---|---|
docker-socket-proxy |
tecnativa/docker-socket-proxy:v0.5.0 |
โ | Secure Docker socket proxy for the agent |
dockflare-agent |
alplat/dockflare-agent:latest@sha256:760397a9a73e8ce09c02575e8e2d69f099ab1958e41af6adddd520623b4fdbc4 |
โ | Reports Docker label events to central DockFlare |
docker-socket-proxy |
tecnativa/docker-socket-proxy:v0.5.0 |
โ | Secure Docker socket proxy for the agent |
dockflare-agent |
alplat/dockflare-agent:latest@sha256:760397a9a73e8ce09c02575e8e2d69f099ab1958e41af6adddd520623b4fdbc4 |
โ | Reports Docker label events to central DockFlare |
3. Networking
cloudflare-netโ Agent connects to Cloudflare Tunnel via this network.dockflare-internalโ Bridge network for agent โ socket-proxy.
4. Persistent Storage
| Container | Host Path / Volume | Description |
|---|---|---||
| docker-socket-proxy | /var/run/docker.sock | โ |
| dockflare-agent | dockflare_agent_data | โ |
| docker-socket-proxy | /var/run/docker.sock | โ |
| dockflare-agent | dockflare_agent_data | โ |
5. Environment Variables
| Variable | Service | Description |
|---|---|---|
CONTAINERS |
docker-socket-proxy |
โ |
DOCKER_HOST |
docker-socket-proxy |
โ |
EVENTS |
docker-socket-proxy |
โ |
EXEC |
docker-socket-proxy |
โ |
IMAGES |
docker-socket-proxy |
โ |
INFO |
docker-socket-proxy |
โ |
NETWORKS |
docker-socket-proxy |
โ |
PING |
docker-socket-proxy |
โ |
POST |
docker-socket-proxy |
โ |
CONTAINERS |
docker-socket-proxy |
โ |
DOCKER_HOST |
docker-socket-proxy |
โ |
EVENTS |
docker-socket-proxy |
โ |
EXEC |
docker-socket-proxy |
โ |
IMAGES |
docker-socket-proxy |
โ |
INFO |
docker-socket-proxy |
โ |
NETWORKS |
docker-socket-proxy |
โ |
PING |
docker-socket-proxy |
โ |
POST |
docker-socket-proxy |
โ |
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