How julicraft44/ha-cloudflare-tunnel works
This repository packages a Home Assistant add-on that exposes a Home Assistant instance through a token-authenticated Cloudflare Tunnel. The main workflow is configuring and starting the add-on, running cloudflared, and monitoring its readiness and metrics to update Home Assistant sensor entities; the README also documents automatic tunnel restart when it drops. The monitor’s polling and entity updates are visible in source. Service startup wiring and restart behavior are not shown in the excerpts, so those links rely only on README documentation or are left unverified.
Main entry points: monitor.py Metrics Monitor · cloudflare_tunnel/run cloudflared Service · config.yaml Add-on Configuration · cloudflare_tunnel_monitor/run Monitor Service
Components 10
Configuration
- Add-on Configuration
cloudflare_tunnel/config.yaml
Tunnel Runtime
- cloudflared Service
cloudflare_tunnel/rootfs/etc/services.d/cloudflare_tunnel/run - Tunnel Restart
cloudflare_tunnel/rootfs/etc/services.d/cloudflare_tunnel/run
Health Monitoring
- Monitor Service
cloudflare_tunnel/rootfs/etc/services.d/cloudflare_tunnel_monitor/run - Metrics Monitor
cloudflare_tunnel/monitor.py
Home Assistant
- Tunnel Sensor Entities
cloudflare_tunnel/monitor.py - Home Assistant API
Other components
- Home Assistant User
- Cloudflare Tunnel
- Home Assistant Instance
Connections 10
- Home Assistant User → Add-on Configuration: configures
README.md - Add-on Configuration → cloudflared Service: starts with
- cloudflared Service → Cloudflare Tunnel: connects to
README.md - Cloudflare Tunnel → Home Assistant Instance: routes requests
README.md - Monitor Service → Metrics Monitor: runs
- Metrics Monitor → Cloudflare Tunnel: polls readiness and metrics
cloudflare_tunnel/monitor.py - Metrics Monitor → Home Assistant API: posts state updates
cloudflare_tunnel/monitor.py - Home Assistant API → Tunnel Sensor Entities: updates
cloudflare_tunnel/monitor.py - Metrics Monitor → Tunnel Sensor Entities: defines entity states
cloudflare_tunnel/monitor.py - cloudflared Service → Tunnel Restart: restarts on drop
README.md