From bab21d07fe483babd8a42e3e51f8c2bb1ecd25c6 Mon Sep 17 00:00:00 2001 From: Ranbel Sun Date: Thu, 26 Jun 2025 15:17:52 -0400 Subject: [PATCH 1/5] add status messages --- .../warp/deployment/manual-deployment.mdx | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx index ba76920e7a20a1a..de67aca751c97b6 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx @@ -146,3 +146,29 @@ The device is now protected by your organization's Zero Trust policies. ## Virtual machines By default, virtual machines (VMs) are subject to the WARP client settings of the host. If you want to deploy a separate instance of WARP in a VM, you must configure the VM to operate in bridged networking mode. + +## Connectivity status + +The WARP client GUI displays the following status messages when transitioning from a **Disconnected** to **Connected** state. These messages indicate the connectivity stage of the WARP daemon as it establishes a connection from the device to Cloudflare. Not all status messages will be displayed; the ones that appear depend on the [WARP mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/). + +To print status messages to the console, run the `warp-cli -l status` command before turning on the WARP switch. + +| Status message | Description | +| --------------------- | ------------------------ | +| Initializing settings | Initializes connection components based on your [WARP settings](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/). | +| Checking network | Validates Ethernet and/or Wi-Fi network connectivity. | +| Performing Happy Eyeballs | Checks for IPv4 and IPv6 connectivity to Cloudflare using the [Happy Eyeballs algorithm](https://datatracker.ietf.org/doc/html/rfc6555). | +| Establishing connection | Connects to the endpoint discovered by Happy Eyeballs. | +| Initializing tunnel interface | Creates a [virtual network interface](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#virtual-interface) on the operating system. | +| Configuring initial firewall | Configures the system firewall to allow WARP tunnel traffic. | +| Setting routes | Updates the [system routing table](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#routing-table) based on your [Split Tunnel rules](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/). | +| Configuring firewall rules | Configures the [system firewall](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#system-firewall) based on your Split Tunnel rules. | +| Checking for route to DNS endpoint | Checks connectivity to ` .cloudflare-gateway.com`. | +| Configuring local sockets | Configures the local DNS proxy sockets for DNS resolution. | +| Configuring local DNS proxy | Creates a [local DNS proxy](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#dns-traffic) on the device.| +| Applying DNS settings | Sets the local DNS proxy as the default DNS server on the device. | +| Configuring forward proxy | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Configures the SOCKS proxy. | +| Performing connectivity checks | Checks connectivity to [destinations](/cloudflare-one/connections/connect-devices/warp/deployment/firewall/#connectivity-checks) inside and outside of the WARP tunnel. | +| Validating DNS configuration | Verifies that DNS requests are answered by WARP's local DNS proxy. | +| Validating proxy configuration | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Verifies the SOCKS proxy configuration. | + From 969c0467918db378d6e29a5bae9681bf7413601e Mon Sep 17 00:00:00 2001 From: Ranbel Sun Date: Thu, 26 Jun 2025 16:46:14 -0400 Subject: [PATCH 2/5] revise wording --- .../connect-devices/warp/deployment/manual-deployment.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx index de67aca751c97b6..15b0dabae36b1d8 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx @@ -149,7 +149,7 @@ By default, virtual machines (VMs) are subject to the WARP client settings of th ## Connectivity status -The WARP client GUI displays the following status messages when transitioning from a **Disconnected** to **Connected** state. These messages indicate the connectivity stage of the WARP daemon as it establishes a connection from the device to Cloudflare. Not all status messages will be displayed; the ones that appear depend on the [WARP mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/). +The WARP client GUI displays the following status messages when transitioning from a **Disconnected** to **Connected** state. These messages indicate the connectivity stage of the WARP daemon as it establishes a connection from the device to Cloudflare. The [WARP mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/) determines which messages are displayed during the connection process. If WARP encounters an error while connecting, the status message will change to an [error code](/cloudflare-one/connections/connect-devices/warp/troubleshooting/client-errors/). To print status messages to the console, run the `warp-cli -l status` command before turning on the WARP switch. From 24afb260d30be2b15343fcbfaab3994d7094f057 Mon Sep 17 00:00:00 2001 From: Ranbel Sun Date: Fri, 27 Jun 2025 13:11:44 -0400 Subject: [PATCH 3/5] update status messages --- .../warp/deployment/manual-deployment.mdx | 27 ++++++++++--------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx index 15b0dabae36b1d8..9de6c4785f7561b 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx @@ -155,20 +155,21 @@ To print status messages to the console, run the `warp-cli -l status` command be | Status message | Description | | --------------------- | ------------------------ | -| Initializing settings | Initializes connection components based on your [WARP settings](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/). | -| Checking network | Validates Ethernet and/or Wi-Fi network connectivity. | -| Performing Happy Eyeballs | Checks for IPv4 and IPv6 connectivity to Cloudflare using the [Happy Eyeballs algorithm](https://datatracker.ietf.org/doc/html/rfc6555). | -| Establishing connection | Connects to the endpoint discovered by Happy Eyeballs. | -| Initializing tunnel interface | Creates a [virtual network interface](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#virtual-interface) on the operating system. | -| Configuring initial firewall | Configures the system firewall to allow WARP tunnel traffic. | -| Setting routes | Updates the [system routing table](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#routing-table) based on your [Split Tunnel rules](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/). | -| Configuring firewall rules | Configures the [system firewall](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#system-firewall) based on your Split Tunnel rules. | -| Checking for route to DNS endpoint | Checks connectivity to ` .cloudflare-gateway.com`. | -| Configuring local sockets | Configures the local DNS proxy sockets for DNS resolution. | -| Configuring local DNS proxy | Creates a [local DNS proxy](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#dns-traffic) on the device.| +| Verifying connection settings | Initializes connection components based on your [WARP settings](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/). | +| Validating network | Validates Ethernet and/or Wi-Fi network connectivity. | +| Initializing IP connection | Checks for IPv4 and IPv6 connectivity to Cloudflare using the [Happy Eyeballs algorithm](https://datatracker.ietf.org/doc/html/rfc6555). | +| Establishing a connection | Connects to the endpoint discovered by Happy Eyeballs. | +| Building a Tunnel | Creates a [virtual network interface](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#virtual-interface) on the operating system for the WARP tunnel. | +| Configuring the firewall | Configures the system firewall to allow WARP tunnel traffic. | +| Setting up your routing table | Updates the [system routing table](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#routing-table) based on your [Split Tunnel rules](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/). | +| Configuring your firewall rules | Configures the [system firewall](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#system-firewall) based on your Split Tunnel rules. | +| Checking connectivity to DNS| Checks connectivity to the DNS endpoint (` .cloudflare-gateway.com`). | +| Setting local endpoint communication | Configures local DNS proxy sockets. | +| Configuring local DNS proxy | Creates a [local DNS proxy](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#dns-traffic) for DNS resolution.| | Applying DNS settings | Sets the local DNS proxy as the default DNS server on the device. | | Configuring forward proxy | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Configures the SOCKS proxy. | -| Performing connectivity checks | Checks connectivity to [destinations](/cloudflare-one/connections/connect-devices/warp/deployment/firewall/#connectivity-checks) inside and outside of the WARP tunnel. | +| Confirming Tunnel connection | Checks connectivity to [destinations](/cloudflare-one/connections/connect-devices/warp/deployment/firewall/#connectivity-checks) inside and outside of the WARP tunnel. | | Validating DNS configuration | Verifies that DNS requests are answered by WARP's local DNS proxy. | -| Validating proxy configuration | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Verifies the SOCKS proxy configuration. | +| Verifying SOCKS proxy configuration | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Verifies the SOCKS proxy configuration. | +| Ensuring MTLS identity | (Only in [Device Information Only mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/device-information-only/)) Installs a client certificate for mTLS authentication. | From eeb116fcd79c72f4457b710914cd004a234dc2b8 Mon Sep 17 00:00:00 2001 From: Ranbel Sun Date: Fri, 27 Jun 2025 17:43:09 -0400 Subject: [PATCH 4/5] move content to Troubleshooting --- .../warp/deployment/manual-deployment.mdx | 29 +--------------- .../troubleshooting/connectivity-status.mdx | 33 +++++++++++++++++++ 2 files changed, 34 insertions(+), 28 deletions(-) create mode 100644 src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx index 9de6c4785f7561b..194a77f28106a56 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/deployment/manual-deployment.mdx @@ -145,31 +145,4 @@ The device is now protected by your organization's Zero Trust policies. ## Virtual machines -By default, virtual machines (VMs) are subject to the WARP client settings of the host. If you want to deploy a separate instance of WARP in a VM, you must configure the VM to operate in bridged networking mode. - -## Connectivity status - -The WARP client GUI displays the following status messages when transitioning from a **Disconnected** to **Connected** state. These messages indicate the connectivity stage of the WARP daemon as it establishes a connection from the device to Cloudflare. The [WARP mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/) determines which messages are displayed during the connection process. If WARP encounters an error while connecting, the status message will change to an [error code](/cloudflare-one/connections/connect-devices/warp/troubleshooting/client-errors/). - -To print status messages to the console, run the `warp-cli -l status` command before turning on the WARP switch. - -| Status message | Description | -| --------------------- | ------------------------ | -| Verifying connection settings | Initializes connection components based on your [WARP settings](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/). | -| Validating network | Validates Ethernet and/or Wi-Fi network connectivity. | -| Initializing IP connection | Checks for IPv4 and IPv6 connectivity to Cloudflare using the [Happy Eyeballs algorithm](https://datatracker.ietf.org/doc/html/rfc6555). | -| Establishing a connection | Connects to the endpoint discovered by Happy Eyeballs. | -| Building a Tunnel | Creates a [virtual network interface](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#virtual-interface) on the operating system for the WARP tunnel. | -| Configuring the firewall | Configures the system firewall to allow WARP tunnel traffic. | -| Setting up your routing table | Updates the [system routing table](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#routing-table) based on your [Split Tunnel rules](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/). | -| Configuring your firewall rules | Configures the [system firewall](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#system-firewall) based on your Split Tunnel rules. | -| Checking connectivity to DNS| Checks connectivity to the DNS endpoint (` .cloudflare-gateway.com`). | -| Setting local endpoint communication | Configures local DNS proxy sockets. | -| Configuring local DNS proxy | Creates a [local DNS proxy](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#dns-traffic) for DNS resolution.| -| Applying DNS settings | Sets the local DNS proxy as the default DNS server on the device. | -| Configuring forward proxy | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Configures the SOCKS proxy. | -| Confirming Tunnel connection | Checks connectivity to [destinations](/cloudflare-one/connections/connect-devices/warp/deployment/firewall/#connectivity-checks) inside and outside of the WARP tunnel. | -| Validating DNS configuration | Verifies that DNS requests are answered by WARP's local DNS proxy. | -| Verifying SOCKS proxy configuration | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Verifies the SOCKS proxy configuration. | -| Ensuring MTLS identity | (Only in [Device Information Only mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/device-information-only/)) Installs a client certificate for mTLS authentication. | - +By default, virtual machines (VMs) are subject to the WARP client settings of the host. If you want to deploy a separate instance of WARP in a VM, you must configure the VM to operate in bridged networking mode. \ No newline at end of file diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx new file mode 100644 index 000000000000000..5b1814994b1054f --- /dev/null +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx @@ -0,0 +1,33 @@ +--- +pcx_content_type: reference +title: Connectivity status +sidebar: + order: 10 + +--- + +import { } from "~/components" + +The WARP client GUI displays the following status messages when transitioning from a **Disconnected** to **Connected** state. These messages indicate the connectivity stage of the WARP daemon as it establishes a connection from the device to Cloudflare. The [WARP mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/) determines which messages are displayed during the connection process. If WARP encounters an error while connecting, the status message will change to an [error code](/cloudflare-one/connections/connect-devices/warp/troubleshooting/client-errors/). + +To print status messages to the console, run the `warp-cli -l status` command before turning on the WARP switch. + +| Status message | Description | +| --------------------- | ------------------------ | +| Verifying connection settings | Initializes connection components based on your [WARP settings](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/). | +| Validating network | Validates Ethernet and/or Wi-Fi network connectivity. | +| Initializing IP connection | Checks for IPv4 and IPv6 connectivity to Cloudflare using the [Happy Eyeballs algorithm](https://datatracker.ietf.org/doc/html/rfc6555). | +| Establishing a connection | Connects to the endpoint discovered by Happy Eyeballs. | +| Building a Tunnel | Creates a [virtual network interface](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#virtual-interface) on the operating system for the WARP tunnel. | +| Configuring the firewall | Configures the system firewall to allow WARP tunnel traffic. | +| Setting up your routing table | Updates the [system routing table](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#routing-table) based on your [Split Tunnel rules](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/). | +| Configuring your firewall rules | Configures the [system firewall](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#system-firewall) based on your Split Tunnel rules. | +| Checking connectivity to DNS| Checks connectivity to the DNS endpoint (` .cloudflare-gateway.com`). | +| Setting local endpoint communication | Configures local DNS proxy sockets. | +| Configuring local DNS proxy | Creates a [local DNS proxy](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#dns-traffic) for DNS resolution.| +| Applying DNS settings | Sets the local DNS proxy as the default DNS server on the device. | +| Configuring forward proxy | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Configures the SOCKS proxy. | +| Confirming Tunnel connection | Checks connectivity to [destinations](/cloudflare-one/connections/connect-devices/warp/deployment/firewall/#connectivity-checks) inside and outside of the WARP tunnel. | +| Validating DNS configuration | Verifies that DNS requests are answered by WARP's local DNS proxy. | +| Verifying SOCKS proxy configuration | (Only in [Proxy mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/#proxy-mode)) Verifies the SOCKS proxy configuration. | +| Ensuring MTLS identity | (Only in [Device Information Only mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/device-information-only/)) Installs a client certificate for mTLS authentication. | From f2277fcdb329995bbe63e07a68bcef1366e91de7 Mon Sep 17 00:00:00 2001 From: ranbel <101146722+ranbel@users.noreply.github.com> Date: Mon, 30 Jun 2025 14:35:27 -0400 Subject: [PATCH 5/5] Update src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx Co-authored-by: Kate Tungusova <70746074+deadlypants1973@users.noreply.github.com> --- .../warp/troubleshooting/connectivity-status.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx index 5b1814994b1054f..9e21ba3e523f31a 100644 --- a/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx +++ b/src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/connectivity-status.mdx @@ -22,7 +22,7 @@ To print status messages to the console, run the `warp-cli -l status` command be | Configuring the firewall | Configures the system firewall to allow WARP tunnel traffic. | | Setting up your routing table | Updates the [system routing table](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#routing-table) based on your [Split Tunnel rules](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/). | | Configuring your firewall rules | Configures the [system firewall](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#system-firewall) based on your Split Tunnel rules. | -| Checking connectivity to DNS| Checks connectivity to the DNS endpoint (` .cloudflare-gateway.com`). | +| Checking connectivity to DNS| Checks connectivity to the DNS endpoint (`.cloudflare-gateway.com`). | | Setting local endpoint communication | Configures local DNS proxy sockets. | | Configuring local DNS proxy | Creates a [local DNS proxy](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#dns-traffic) for DNS resolution.| | Applying DNS settings | Sets the local DNS proxy as the default DNS server on the device. |