danmuller/cloudflared repository overview

This Docker image provides a lightweight container for running Cloudflare tunnels using the official cloudflared daemon. Based on Alpine Linux, it offers a minimal footprint while providing full cloudflared functionality.

⁠Features

• Based on Alpine Linux 3.19 for minimal image size
• Automatically fetches the latest stable cloudflared release
• Pre-configured with cloudflared as the entrypoint
• Ready for use with Cloudflare tunnel configurations

⁠Usage

⁠Basic Usage

docker run danmuller/cloudflared:latest tunnel --no-autoupdate --url http://localhost:3000

⁠Docker Compose

services:
  tunnel:
    image: danmuller/cloudflared:latest
    command: 'tunnel --no-autoupdate --url http://localhost:3000'

⁠Configuration Examples

The container uses cloudflared as its entrypoint, allowing you to pass tunnel commands directly. Here are some common configuration patterns:

# Run a tunnel to a local HTTP service
docker run danmuller/cloudflared tunnel --url http://localhost:8000

# Run with no automatic updates
docker run danmuller/cloudflared tunnel --no-autoupdate --url http://localhost:8000

# Run with a specific configuration file
docker run -v ~/.cloudflared:/etc/cloudflared danmuller/cloudflared tunnel --config /etc/cloudflared/config.yml run

⁠Building From Source

The Dockerfile is available on GitHub. To build the image locally:

docker build -t danmuller/cloudflared .

⁠Official Links

• Docker Hub: danmuller/cloudflared⁠
• Cloudflare Documentation: Cloudflare Tunnel Documentation⁠
• Cloudflared Source: cloudflared GitHub Repository⁠

⁠Support

For cloudflared-specific issues, please refer to the official Cloudflare documentation and GitHub repository. For container-specific issues, please use the Docker Hub repository's issue tracker.

⁠License

This Docker image includes cloudflared, which is licensed under the Apache License 2.0. The Dockerfile and associated configuration files are available under the same license.