🔧 Cloud Tools — Dockflare Agents (Gaius & Starbuck)

Host: Cloud – Both VPS nodes · Composes: Cloud/Gaius/tools/compose.yaml and Cloud/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:d5a72f81daab1635832a949a1b9960cfa5082f39e4394f495ef00c954f31cd76`	—	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:d5a72f81daab1635832a949a1b9960cfa5082f39e4394f495ef00c954f31cd76`	—	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

7. Maintenance & Backup

docker compose -f Cloud/Gaius/tools/compose.yaml pull && docker compose -f Cloud/Gaius/tools/compose.yaml up -d
docker compose -f Cloud/Starbuck/tools/compose.yaml pull && docker compose -f Cloud/Starbuck/tools/compose.yaml up -d