Repolode
Submit
ChrispyBacon-dev

ChrispyBacon-dev/DockFlare

Self-hosted tool that automatically creates Cloudflare Tunnel routes, DNS records and Access policies from Docker container labels.

View on GitHubWebsite
Stars
2,491
Forks
107
Open issues
4
Last commit
18 days ago

What is it?

DockFlare runs alongside your Docker containers and keeps Cloudflare Tunnel ingress rules, DNS records and Cloudflare Access applications in sync with what is running. You declare a hostname, backend service and access group with container labels, and DockFlare creates the matching Cloudflare resources without manual dashboard edits. Routes for hosts that are not Docker containers can be added through its web UI, and both sources are merged into one reconciliation loop.

It also supports multi-host setups: a central master manages policy and Cloudflare configuration while lightweight agents on remote Docker hosts report container events and run commands. Access Groups can be reused across several services, and backups of its encrypted configuration and state can be exported and restored. An optional email suite built on Cloudflare Email Routing, Workers and R2 is included as a separate profile.

Setup requires a Cloudflare API token with scoped permissions for Tunnel, Access and DNS, plus Docker, Docker Compose and Redis. The project provides a one-line install script and a Docker Compose stack that recommends a Docker socket proxy for limited Docker API access.

Key features

  • 01Creates Cloudflare Tunnel ingress rules and DNS records from Docker labels.
  • 02Supports manual routes for VMs, appliances and other non-container services.
  • 03Manages reusable Access Groups and Cloudflare Access applications.
  • 04Runs remote agents on multiple Docker hosts under one central master.
  • 05Exports and restores encrypted configuration and runtime state.
  • 06Offers an optional self-hosted email suite on Cloudflare Email Routing.

Use cases

  • Exposing a homelab's self-hosted apps through Cloudflare Tunnel without editing the dashboard for each service.
  • Protecting internal web tools behind Cloudflare Access with shared access groups.
  • Managing public hostnames across several Docker hosts from one web UI.

Quick start

  1. 1

    Create the shared Docker network

    docker network create cloudflare-net
  2. 2

    Create docker-compose.yml using the Quick Start Docker Compose file from the README

  3. 3

    Start DockFlare

    docker compose up -d
  4. 4

    Open http://your-server-ip:5000 in a browser and complete the setup wizard

Things to know

  • Needs a Cloudflare account with an API token that has several specific permissions.
  • Requires Docker plus a Redis instance, which the quick-start stack includes.
  • The README badge lists GPL-3.0, while the repository metadata has no clear license, so check the LICENSE file before use.

In collections

Self-hosted apps

Topics

#cloudflare#docker#cloudflare-tunnel#zero-trust#homelab#reverse-proxy#selfhosted#dns#api-integration#automation

FAQ

What is DockFlare?
Self-hosted tool that automatically creates Cloudflare Tunnel routes, DNS records and Access policies from Docker container labels. DockFlare runs alongside your Docker containers and keeps Cloudflare Tunnel ingress rules, DNS records and Cloudflare Access applications in sync with what is running. You declare a hostname, backend service and access group with container labels, and DockFlare creates the matching Cloudflare resources without manual dashboard edits. Routes for hosts that are not Docker containers can be added through its web UI, and both sources are merged into one reconciliation loop.
Is DockFlare free to use? What license does it have?
DockFlare is open source under the Other license. Check the license terms before using it in commercial products.
Is DockFlare still maintained?
Actively maintained. The last commit to DockFlare was on Oct 6, 2026.
What can I use DockFlare for?
Exposing a homelab's self-hosted apps through Cloudflare Tunnel without editing the dashboard for each service. Protecting internal web tools behind Cloudflare Access with shared access groups. Managing public hostnames across several Docker hosts from one web UI.
How do I install DockFlare?
Create the shared Docker network: docker network create cloudflare-net Create docker-compose.yml using the Quick Start Docker Compose file from the README Start DockFlare: docker compose up -d Open http://your-server-ip:5000 in a browser and complete the setup wizard
Where can I get DockFlare?
The source code and installation instructions are on GitHub: https://github.com/ChrispyBacon-dev/DockFlare

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects