How marvinvr/docktail works
DockTail is an agent that discovers Docker containers configured with labels and exposes them as native Tailscale Services. Its main loop reconciles desired container services against Tailscale; Tailscale Serve then proxies traffic to container backends. A separate, opt-in Cloud branch reports host and container state, while Funnel supports public exposure. The graph follows the README and sampled entry-point, reconciliation, Docker, Tailscale, and Cloud code; unsampled subsystem links are included only where documented, and other internal Cloud relationships are left out where call sites were not shown.
Main entry points: collector.go Cloud collector · main.go Agent startup · tailscale/client.go Tailscale client · docker/client.go Docker discovery
Components 23
Agent and reconciliation
- Agent startup
main.go - Docker discovery
docker/client.go - Service reconciliation
reconciler/reconciler.go - Health reporting
health/health.go
Tailscale exposure
- Tailscale client
tailscale/client.go - Serve services
tailscale/service.go - Funnel exposure
tailscale/funnel.go
Cloud reporting
- Cloud collector
cloud/collector.go - Cloud inventory
docker/cloud.go - Service checks
cloud/checks.go - Tailnet probes
cloud/tailnet.go - Host metrics
cloud/hostmetrics.go - Host filesystems
cloud/hostfs_linux.go - Cloud connection
cloud/wsclient.go - Cloud protocol
cloud/proto/messages.go - Offline spool
cloud/spool.go
Shared runtime
- Service model
types/types.go
Other components
- Operator
- Docker Engine
- Tailnet client
- tailscaled
- Tailscale control plane
- DockTail Cloud
Connections 29
- Operator → Agent startup: configures
README.md - Agent startup → Docker discovery: creates
main.go - Agent startup → Tailscale client: creates
main.go - Agent startup → Service reconciliation: runs
main.go - Agent startup → Cloud collector: starts optionally
main.go - Agent startup → Health reporting: tracks status
main.go - Docker Engine → Docker discovery: provides containers
README.md - Operator → Docker Engine: labels containers
README.md - Service reconciliation → Docker discovery: discovers services
reconciler/reconciler.go - Service reconciliation → Tailscale client: reconciles services
reconciler/reconciler.go - Docker discovery → Service model: builds service models
docker/client.go - Tailscale client → Serve services: reconciles Serve
tailscale/client.go - Tailscale client → Tailscale control plane: manages definitions
tailscale/client.go - Tailscale client → Funnel exposure: reconciles funnels
- Serve services → tailscaled: configures proxy
README.md - tailscaled → Docker Engine: proxies traffic
README.md - Tailnet client → tailscaled: requests service
README.md - Funnel exposure → tailscaled: enables public access
README.md - Cloud collector → Cloud inventory: reads inventory
cloud/collector.go - Cloud collector → Cloud connection: sends reports
- Cloud collector → Cloud protocol: encodes reports
cloud/collector.go - Cloud connection → DockTail Cloud: reports outbound
README.md - DockTail Cloud → Cloud collector: requests probes
- Cloud collector → Tailnet probes: checks control state
- Cloud collector → Service checks: runs checks
- Cloud collector → Host metrics: samples host
- Host metrics → Host filesystems: reads filesystems
- Cloud collector → Offline spool: buffers offline
- Cloud collector → Service model: maps service data
cloud/collector.go