Skip to content

Commit 003acd9

Browse files
committed
fix: document Mesh as recommended on-ramp for L4/connection-sensitive workloads
- Add SAP, database replication, ERP systems, RDP sessions to Mesh use cases - Note that Mesh preserves long-lived TCP connections end-to-end (L3/L4) - Add 'Connection handling' row to comparison table - Position Mesh as recommended software on-ramp for connection-sensitive traffic
1 parent 1cae76a commit 003acd9

4 files changed

Lines changed: 18 additions & 3 deletions

File tree

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ Both Cloudflare Mesh and [Cloudflare Tunnel](/cloudflare-one/networks/connectors
8484
| **Connector** | `warp-cli` | `cloudflared` |
8585
| **Protocols** | TCP, UDP, ICMP | HTTP/S, TCP, SSH, RDP, SMB (proxied over WebSocket) |
8686

87-
Use Mesh when devices need to reach each other by private IP. Use Tunnel when you want to publish services by hostname or proxy traffic to specific IP ranges through `cloudflared`.
87+
Use Mesh when devices need to reach each other by private IP, or when your workload requires stable, long-lived TCP connections (SAP, database replication, ERP systems, RDP sessions). Mesh operates at L3/L4 and preserves connections end-to-end, making it the recommended software on-ramp for any traffic sensitive to connection interruptions. Use Tunnel when you want to publish services by hostname or proxy traffic to specific IP ranges through `cloudflared`.
8888

8989
<Details header="Coming from another mesh networking product?">
9090

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

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,18 @@ Mesh nodes run in [Traffic and DNS mode](/cloudflare-one/team-and-resources/devi
101101

102102
If your server runs a DNS service, do not install the Mesh node on that host. Instead, install the node on a separate machine on the same subnet and use [CIDR routes](/cloudflare-one/networks/connectors/cloudflare-mesh/routes/) to make the DNS server reachable.
103103

104+
## Running Mesh alongside other VPN or mesh software
105+
106+
The Cloudflare One Client creates a virtual network interface and manages the system routing table. Other software that does the same — Tailscale, WireGuard, OpenVPN, Cisco AnyConnect, GlobalProtect, ZScaler, Netskope, or any traditional VPN client — will compete for control of routing. Running them simultaneously causes unpredictable behavior: traffic may flow through the wrong tunnel or fail entirely.
107+
108+
If you are migrating to Cloudflare Mesh from another solution:
109+
110+
1. Uninstall or disable the other client (for example, `sudo systemctl stop tailscaled && sudo systemctl disable tailscaled` on Linux, or quit the application from the system tray on macOS/Windows).
111+
2. Restart the machine so the Cloudflare One Client's virtual network interface takes priority in the routing table.
112+
3. Verify connectivity by running `warp-cli status` and pinging a Mesh IP.
113+
114+
This applies to both Mesh nodes and client devices.
115+
104116
## Running Mesh with Cloudflare Tunnel
105117

106118
A Mesh node (`warp-cli`) and [Cloudflare Tunnel](/cloudflare-one/networks/connectors/cloudflare-tunnel/) (`cloudflared`) can run on the same Linux host. This is useful when you want to use the Mesh node as a gateway for your private network while also using Cloudflare Tunnel to publish specific applications.

src/content/docs/learning-paths/replace-vpn/connect-private-network/cloudflare-mesh.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,10 @@ The setup wizard in the dashboard configures enrollment, device profiles, and co
1919

2020
- Replacing a VPN for remote access to private networks
2121
- Bidirectional connectivity (VoIP, SIP, Active Directory, SCCM, DevOps pipelines)
22+
- Long-lived TCP connections sensitive to interruptions (SAP, database replication, ERP systems, RDP sessions)
2223
- Site-to-site networking between offices, data centers, or cloud VPCs
2324
- Client-to-client connectivity (two laptops reaching each other by private IP)
25+
- Any L3/L4 workload where source IP preservation matters
2426

2527
## Best practices
2628

src/content/docs/learning-paths/replace-vpn/connect-private-network/connection-methods.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,14 +35,15 @@ There are [multiple ways](/reference-architecture/architectures/sase/#connecting
3535
| Host machine | Linux (amd64, arm64) | Linux, macOS, Windows |
3636
| IPv4 |||
3737
| IPv6 |||
38-
| OSI layer | L3 | L4 |
38+
| OSI layer | L3 | L7 |
3939
| Protocol | MASQUE | QUIC or HTTP/2 |
4040
| Protocols proxied | TCP, UDP, ICMP | HTTP/S, TCP, SSH, RDP, SMB |
41+
| Connection handling | End-to-end — preserves long-lived TCP connections across the full path | Proxied — TCP connections are terminated and re-established at Cloudflare's edge, which can interrupt long-lived sessions (for example, SAP transactions, database replication streams, or persistent RDP sessions may drop when `cloudflared` reconnects to the edge) |
4142

4243
## Recommendation
4344

4445
For most VPN replacement scenarios, [Cloudflare Tunnel](/learning-paths/replace-vpn/connect-private-network/cloudflared/) is the easiest way to get started. It runs on all platforms (Linux, macOS, Windows, containers, Raspberry Pi), does not require return route configuration (traffic is source-NATed to the `cloudflared` host), and does not interfere with existing VPN software on the same machine.
4546

46-
Use [Cloudflare Mesh](/learning-paths/replace-vpn/connect-private-network/cloudflare-mesh/) when you need bidirectional connectivity with server-initiated traffic (VoIP, SIP, AD updates, SCCM), site-to-site networking between multiple locations, or deployments where preserving the original source IP is important.
47+
Use [Cloudflare Mesh](/learning-paths/replace-vpn/connect-private-network/cloudflare-mesh/) when you need bidirectional connectivity with server-initiated traffic (VoIP, SIP, AD updates, SCCM), site-to-site networking between multiple locations, deployments where preserving the original source IP is important, or workloads with long-lived TCP connections sensitive to interruptions (SAP, database replication, ERP systems).
4748

4849
Both methods can be used together. For example, use Tunnel for straightforward user-to-application access and add Mesh nodes where you need bidirectional or site-to-site connectivity.

0 commit comments

Comments
 (0)