Warp
Cloudflare WARP is a Docker container that runs the official WARP client, routing your server's outbound traffic through Cloudflare's WARP network.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
61/100 Good
- Maintained
- 64last commit 112 days ago
- Popular
- 601,057 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 602 GB minimum RAM, runs on ARM
- Security check
- 85no serious findings, CI
Availability: platform listings confirmed today, links checked 52 days ago
- GitHub stars
- 1,057
- Open issues
- 3
- Last commit
- 2026-08-01
- License
- GPL-3.0
- Activity
- stale
Checked 20 days ago - source: GitHub (cmj2002/warp-docker)
Resources & Compatibility
Minimum requirements: 2 GB RAM. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Check Docker works first Run docker info to check Docker (a tool that runs apps in isolated containers) is installed and its background service is running. Without that, the Warp worker container cannot start. source
- Set the API key and Docker socket Before running the worker, set WARP_API_KEY, the access code Warp gives you, and mount the host Docker socket, the file that lets the worker container ask the host's Docker to create containers, with -v /var/run/docker.sock:/var/run/docker.sock. Without the key the worker can't authenticate to Warp, and without the socket it can't launch containers. source
- Use the guided setup wizard Run /create-environment to let Warp inspect your repositories and recommend configuration settings. This first-run flow helps you avoid missing a required setup step before the environment starts. source
Fetched 54 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What Docker settings are required for the WARP client to work?
Expose port 1080 and add the NET_ADMIN capability, with MKNOD and AUDIT_WRITE shown for Podman. It also needs the sysctls net.ipv6.conf.all.disable_ipv6=0 and net.ipv4.conf.all.src_valid_mark=1, plus a persistent volume for /var/lib/cloudflare-warp.
Why does the proxy fail right after the container starts?
WARP_SLEEP is the wait time for the WARP daemon before the proxy starts, with a default of 2 seconds. Increase it on slow servers so the daemon starts before proxy use.
Can I change the proxy listener protocol or port?
GOST_ARGS controls the GOST listener, and the default is -L :1080 for HTTP and SOCKS5. Change it for UDP or advanced protocol support, and update the container port mapping if the port changes.
Are the WARP client and GOST versions in the image always current?
The image does not guarantee that the bundled GOST and WARP client are the latest versions. Build your own image if you need current components.
Answers sourced from github.com
Community
- Homelab over Cloudflare Warp : r/selfhosted - Reddit (reddit)
- Setting up port forwarding on Cloudflare Warp : r/selfhosted - Reddit (reddit)
- Self host Cloudflare's WARP? : r/selfhosted - Reddit (reddit)
- I discovered Warp enabled cloudflare : r/selfhosted - Reddit (reddit)
- Did anyone try Cloudflare Zero Trust WARP authentication ... - Reddit (reddit)
Collected 53 days ago - public community threads