cloudflare / cloudflare/cloudflared

🐛Default to EdgeIpVersion of "auto"

Open
#1,518 1 comment 4 reactions 0 assignees View on GitHub
Priority: Normal Type: Bug
Dominant language
Go
Stars
15.6k
Forks
1.4k
PR merge metrics
No merged PRs in 30d

Description

**Describe the bug**
By default, tunnels can't be created on IPv6-only systems since `EdgeIpVersion` defaults to `4` instead of `auto`. This has been discussed in #842 #954 #1019 but those issues have been closed without a change in the default. While it's possible to override the systemd file, that file needs to exist first so using `cloudflared service install` as given in the Cloudflare Dashboard does not result in a working tunnel

**To Reproduce**
Steps to reproduce the behavior:
1. Configure a remote tunnel in the Cloudflare Zero Trust Dashboard
2. Run the `cloudflare service install ...` command given by the dashboard on an IPv6-only device
3. See the command stall
4. Run `systemctl status cloudflared` and see that it's trying to use IPv4 even when there are no IPv4 addresses assigned to any interface (other than the `127.0.0.1` on `lo`)

If it's an issue with Cloudflare Tunnel:
* Tunnel ID : (did not get to registering/creating/connecting)
* cloudflared config: N/A (remote-managed tunnel)

**Expected behavior**
IPv6 should work out of the box (with no systemd overrides needed)

**Environment and versions**
- OS: Debian 13 (Trixie)
- Architecture: x64
- Version: 2025.8.0

**Logs and errors**
N/A

**Additional context**
* IPv6 support is something Cloudflare actively advertises, such as in this blog post (which, while it doesn't use tunnels in the example, still advertises being IPv6 ready): https://blog.cloudflare.com/amazon-2bn-ipv4-tax-how-avoid-paying/
* Not having IPv6 support by default is not well-documented unless you're looking for it, which means that, in addition to the commands in the Dashboard not being correct/complete, it requires spending time searching the docs and GitHub issues to figure out why it's happening
* Needing to override the systemd unit file adds a non-trivial amount of friction to using IPv6 and is not beginner-friendly

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.