Skip to content

Commit c482587

Browse files
committed
fix: make IPv4/IPv6 forwarding persistent in Mesh install commands
- Replace lsb_release with /etc/os-release for broader distro support - Add quiet flags to apt-get for cleaner output - Replace non-persistent sysctl -w with /etc/sysctl.d conf file - Enable net.ipv4.ip_forward, net.ipv6.conf.all.forwarding, accept_ra=2 - Add migration section in tips for existing nodes set up before this change
1 parent 0188e37 commit c482587

2 files changed

Lines changed: 22 additions & 4 deletions

File tree

src/content/docs/cloudflare-one/networks/connectors/cloudflare-mesh/tips.mdx

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,22 @@ import { Tabs, TabItem } from "~/components";
1414

1515
Operational guidance for managing Cloudflare Mesh deployments — updating the client, configuring cloud providers, running alongside Cloudflare Tunnel, and common troubleshooting.
1616

17+
## Make IP forwarding persistent
18+
19+
If your Mesh node was set up before April 2026, it may be using `sysctl -w` for IP forwarding, which does not persist across reboots. If your node loses route connectivity after a server restart, run the following to make forwarding permanent:
20+
21+
```sh
22+
printf 'net.ipv4.ip_forward = 1\nnet.ipv6.conf.all.forwarding = 1\nnet.ipv6.conf.all.accept_ra = 2\n' | sudo tee /etc/sysctl.d/99-zzz-cloudflare-warp-connector.conf && sudo sysctl --system
23+
```
24+
25+
You can verify the settings are active with:
26+
27+
```sh
28+
sysctl net.ipv4.ip_forward net.ipv6.conf.all.forwarding net.ipv6.conf.all.accept_ra
29+
```
30+
31+
New installations include this step automatically.
32+
1733
## Update a Mesh node
1834

1935
Updating a Mesh node means updating the `cloudflare-warp` package on the Linux host. The node briefly disconnects during the update, which interrupts traffic routed through it. If you have [high availability](/cloudflare-one/networks/connectors/cloudflare-mesh/high-availability/) enabled, traffic fails over to a standby replica automatically.

src/content/partials/cloudflare-one/mesh/install-node.mdx

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,10 @@ import { Tabs, TabItem } from "~/components";
99

1010
```sh
1111
curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | sudo gpg --yes --dearmor -o /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg &&
12-
echo "deb [signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflare-client.list &&
13-
sudo apt-get update && sudo apt-get install -y cloudflare-warp &&
14-
sudo sysctl -w net.ipv4.ip_forward=1
12+
echo "deb [signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ $(. /etc/os-release && echo $VERSION_CODENAME) main" | sudo tee /etc/apt/sources.list.d/cloudflare-client.list &&
13+
sudo apt-get update -qq && sudo apt-get install -y -qq cloudflare-warp &&
14+
printf 'net.ipv4.ip_forward = 1\nnet.ipv6.conf.all.forwarding = 1\nnet.ipv6.conf.all.accept_ra = 2\n' | sudo tee /etc/sysctl.d/99-zzz-cloudflare-warp-connector.conf &&
15+
sudo sysctl --system
1516
```
1617

1718
```sh
@@ -24,7 +25,8 @@ sudo warp-cli connector new <TOKEN> && sudo warp-cli connect
2425
```sh
2526
sudo rpm -ivh https://pkg.cloudflareclient.com/cloudflare-release-el8.rpm &&
2627
sudo yum install -y cloudflare-warp &&
27-
sudo sysctl -w net.ipv4.ip_forward=1
28+
printf 'net.ipv4.ip_forward = 1\nnet.ipv6.conf.all.forwarding = 1\nnet.ipv6.conf.all.accept_ra = 2\n' | sudo tee /etc/sysctl.d/99-zzz-cloudflare-warp-connector.conf &&
29+
sudo sysctl --system
2830
```
2931

3032
```sh

0 commit comments

Comments
 (0)