cloudflare-tunnel

cloudflare-tunnel

Docker app from ProphetSe7en's Repository

Overview

Cloudflare Tunnel client with built-in Docker healthcheck.

Identical to the official cloudflare/cloudflared image — the only addition is a HEALTHCHECK instruction using the built-in cloudflared tunnel ready command. No files changed, no packages added, no ports opened.

Why this exists: The official image uses a distroless base with no shell (/bin/sh). Docker's --health-cmd always runs through /bin/sh, so healthchecks added via Extra Parameters will always fail. This image bakes the healthcheck in using exec-form, which bypasses the shell.

Setup:

  1. Go to Cloudflare Zero Trust dashboard (dash.teams.cloudflare.com)
  2. Navigate to Networks > Tunnels > Create a tunnel
  3. Select Cloudflared as connector, give it a name
  4. Choose Docker as the environment — Cloudflare shows you a token
  5. Copy the token and paste it in Post Arguments below, replacing YOUR_TUNNEL_TOKEN_HERE
  6. The TUNNEL_METRICS variable is already set — this is required for the healthcheck
  7. Start the container — it should show as healthy within 30 seconds

Runtime arguments

Network
bridge
Privileged
false

Template configuration

Tunnel MetricsVariable

Enables the metrics server inside the container. Required for the healthcheck to work. The port is internal only and not exposed to the host.

Target
TUNNEL_METRICS
Default
0.0.0.0:60123
Value
0.0.0.0:60123

Categories

Details

Repository
ghcr.io/prophetse7en/cloudflare-tunnel:latest
Last Updated2026-06-01
First Seen2026-04-06

Run cloudflare-tunnel on Unraid.

cloudflare-tunnel is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.