Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
31ac9c1
[Cloudflare One] Draft: intent-based Get Started structure (PCX-20931)
codyanthony850 Mar 2, 2026
4740956
chore: add agents/ to .gitignore
codyanthony850 Mar 2, 2026
afe191c
[Cloudflare One] Add 'why replace your VPN' link to decision page
codyanthony850 Mar 2, 2026
dfe44d9
fix: replace HTML comments with MDX comments in skeleton pages
codyanthony850 Mar 2, 2026
071ddc8
fix: correct 3 broken links in device-to-network next steps
codyanthony850 Mar 2, 2026
8890874
[Cloudflare One] Add dashboard Get Started reference to setup landing…
codyanthony850 Mar 2, 2026
30790db
[Cloudflare One] Point implementation guides 'Replace VPN' to new qui…
codyanthony850 Mar 2, 2026
2ea85df
[Cloudflare One] Rewrite device-to-network to match dashboard 6-step …
codyanthony850 Mar 2, 2026
3747cf3
[Cloudflare One] Narrow PR scope to device-to-network only
codyanthony850 Mar 4, 2026
a6fbc19
[Cloudflare One] Style and content review fixes for device-to-network
codyanthony850 Mar 4, 2026
e501e22
[Cloudflare One] Apply eli5 clarity pass to device-to-network
codyanthony850 Mar 4, 2026
451e3c8
[Cloudflare One] Address reviewer feedback on replace-vpn quick-start
codyanthony850 Mar 4, 2026
8ef9618
[Cloudflare One] Fix Step 3 to match dashboard deploy tunnel UI
codyanthony850 Mar 4, 2026
e7559d3
[Cloudflare One] Polish device-to-network wording and formatting
codyanthony850 Mar 4, 2026
39f8bd1
[Cloudflare One] Add glossary tooltips, account prereq, and parent cr…
codyanthony850 Mar 5, 2026
d94ba95
[Cloudflare One] Remove Cloudflare Tunnel GlossaryTooltip that broke …
codyanthony850 Mar 6, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -40,3 +40,4 @@ CLAUDE.md
.cursor/
.github/prompts/
.github/agents/
agents/
Original file line number Diff line number Diff line change
Expand Up @@ -14,28 +14,30 @@ Implementation guides cover deployment steps and best practices for specific Clo
<CardGrid>

<LinkTitleCard
title="Secure your Internet Traffic and SaaS apps"
title="Secure web traffic from threats"
href="/learning-paths/secure-internet-traffic/concepts/"
icon="seti:lock"
>
Provide your users and networks with a secure, performant, and flexible path
to the Internet.
Inspect and filter all Internet-bound traffic from your users to block
threats, enforce acceptable use policies, and prevent data loss.
</LinkTitleCard>

<LinkTitleCard
title="Replace your VPN"
href="/learning-paths/replace-vpn/concepts/"
href="/cloudflare-one/setup/replace-vpn/"
icon="seti:db"
>
Give users secure, auditable network and application access.
Connect remote users to internal applications and services through a secure
connection. Best for remote access to private networks.
</LinkTitleCard>

<LinkTitleCard
title="Deploy clientless access"
title="Secure private apps without a client"
href="/learning-paths/clientless-access/concepts/"
icon="laptop"
>
Secure access to internal web applications without a device client.
Provide browser-based access to internal web applications, SSH servers, and
RDP sessions without installing software on user devices.
</LinkTitleCard>

<LinkTitleCard
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
pcx_content_type: navigation
title: Replace your VPN
external_link: /learning-paths/replace-vpn/concepts/
external_link: /cloudflare-one/setup/replace-vpn/
sidebar:
order: 2
---
43 changes: 0 additions & 43 deletions src/content/docs/cloudflare-one/setup.mdx

This file was deleted.

72 changes: 72 additions & 0 deletions src/content/docs/cloudflare-one/setup/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
---
pcx_content_type: get-started
title: Get started
sidebar:
order: 2
description: Set up Cloudflare Zero Trust for your organization. Choose a use case to get started with a guided quick-start.
---

import { CardGrid, LinkTitleCard, Render } from "~/components";

Set up Cloudflare Zero Trust to protect your users, devices, and networks. Complete the prerequisites below, then choose a use case to get started.

## Prerequisites

Before you begin any use case, you need a Cloudflare account and a Zero Trust organization.

### 1. Create a Cloudflare account

Sign up for a [Cloudflare account](https://dash.cloudflare.com/sign-up) and enable two-factor authentication.

### 2. Create a Zero Trust organization

<Render file="choose-team-name" product="cloudflare-one" />

## What would you like to do?

These use cases match the guided onboarding in the [Cloudflare One dashboard](https://one.dash.cloudflare.com). To follow along in the dashboard, select **Get Started**.

<CardGrid>

<LinkTitleCard
title="Replace your VPN"
href="/cloudflare-one/setup/replace-vpn/"
icon="seti:db"
>
Give remote users, offices, and devices secure access to private networks and
applications without a traditional VPN.
</LinkTitleCard>

<LinkTitleCard
title="Secure private apps without a client"
href="/learning-paths/clientless-access/concepts/"
icon="laptop"
>
Provide browser-based access to internal web applications, SSH servers, and
RDP sessions without installing software on user devices.
</LinkTitleCard>

<LinkTitleCard
title="Filter DNS to block threats"
href="/cloudflare-one/traffic-policies/initial-setup/dns/"
icon="magnifier"
>
Set up DNS filtering to block malware, phishing, and unwanted content across
your network in minutes.
</LinkTitleCard>

<LinkTitleCard
title="Secure web traffic from threats"
href="/learning-paths/secure-internet-traffic/concepts/"
icon="seti:lock"
>
Inspect and filter all Internet-bound traffic from your users to block
threats, enforce acceptable use policies, and prevent data loss.
</LinkTitleCard>

</CardGrid>

:::note

For in-depth deployment guides that cover policy design and advanced configuration, refer to [Implementation guides](/cloudflare-one/implementation-guides/).
Comment on lines +69 to +71

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
:::note
For in-depth deployment guides that cover policy design and advanced configuration, refer to [Implementation guides](/cloudflare-one/implementation-guides/).
:::note
For in-depth deployment guides that cover policy design and advanced configuration, refer to [Implementation guides](/cloudflare-one/implementation-guides/).

:::
Original file line number Diff line number Diff line change
@@ -0,0 +1,122 @@
---
pcx_content_type: get-started
title: "Device to network"
sidebar:
order: 1
label: Device to network
description: Connect a remote device to a private network using Cloudflare Tunnel and the WARP client.
products:
- cloudflare-one
---

import { GlossaryTooltip } from "~/components";

Connect a remote device to a private network so your users can securely access internal applications and services from anywhere, without the security risks and performance bottlenecks of a traditional VPN.

To explore other connection scenarios, refer to [Replace your VPN](/cloudflare-one/setup/replace-vpn/).

This guide follows the same steps as the **Get Started** onboarding wizard in the [Cloudflare One dashboard](https://one.dash.cloudflare.com).

## How it works

[Cloudflare Tunnel](/cloudflare-one/networks/connectors/cloudflare-tunnel/) is a network connector that creates an outbound-only connection between your private network and Cloudflare. No open inbound ports or firewall changes are required.

The <GlossaryTooltip term="WARP client">[WARP client](/cloudflare-one/team-and-resources/devices/warp/)</GlossaryTooltip> is an app that you install on each user's device. It routes traffic through Cloudflare and into the tunnel, so users can reach internal resources from anywhere.

## Prerequisites

- A Cloudflare account with a Zero Trust organization. If you have not set this up, refer to [Get started](/cloudflare-one/setup/).
- A Linux, Windows, or macOS device on your private network to run the tunnel.
- A Linux, Windows, or macOS device to install the WARP client on.

## Step 1: Assign a Tunnel

Cloudflare Tunnel establishes an outbound connection between your resources and Cloudflare. This is how new devices can reach your private network. You can install Tunnel on any Windows, Mac, or Linux device currently in your private network.

1. In [Cloudflare One](https://one.dash.cloudflare.com), select the **Get Started** tab.
2. For **Replace my client-based or site-to-site VPN**, select **Get started**.
3. For **Device to network**, select **Continue**.
4. On the **Connect a remote device to a private network** screen, select **Continue**.
5. On the **Assign a Tunnel** screen, use the dropdown to choose an existing tunnel or create a new one.
6. Select **Continue**.

## Step 2: Set your Tunnel's IP range

Add the IP range of your private network to the tunnel. This defines which internal resources your remote users can reach. Your tunnel accepts traffic to this range from devices enrolled in your Zero Trust organization.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Add the IP range of your private network to the tunnel. This defines which internal resources your remote users can reach. Your tunnel accepts traffic to this range from devices enrolled in your Zero Trust organization.
Add the IP range of your private network to the tunnel. This defines which internal resources your remote users can reach. Your Tunnel accepts traffic to this range from devices enrolled in your Zero Trust organization.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you're still referring to the app Cloudflare Tunnel. If you're talking about the tunnel the app creates, ignore me

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied — capitalized Tunnel as a product name reference. Included in the device-to-device PR since this one is already merged.


1. Enter your IP range (for example, `10.0.1.0/24`).
2. Select **Continue**.

:::note
If you are not sure of your IP range, check your router or network settings. Common private network ranges include `10.0.0.0/8`, `172.16.0.0/12`, and `192.168.0.0/16`.
:::

## Step 3: Deploy your Tunnel

Install the `cloudflared` connector on a device in your private network and run the tunnel. This service creates the secure connection between your network and Cloudflare.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same question here

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good question — here 'run the tunnel' refers to the action of running the tunnel instance (starting the cloudflared service), not to the Cloudflare Tunnel product. Keeping lowercase to distinguish the action from the product name.


1. Select your device's operating system and architecture.
2. Copy the install command and run it on your device. For Windows, open Command Prompt as an administrator. For all other operating systems, use a terminal window.

For macOS, the command looks similar to:

```sh
brew install cloudflared && sudo cloudflared service install <YOUR_TUNNEL_TOKEN>
```

For Windows and Linux, the dashboard provides a download link and install command for your selected architecture. For more download options, refer to [Downloads](/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads/).

3. After `cloudflared` connects, the dashboard confirms the tunnel is active.
4. Select **Continue**.

## Step 4: Enroll your devices

Device enrollment controls which users can connect their devices to your private network through Cloudflare. In this step, you register your first device by providing an email address and installing the WARP client.

1. Enter the email you want to use to enroll your first device.
2. Select your device's operating system.
3. Select **Download to continue** to download the WARP client, or copy the download link to send to a different device.
4. Select **Continue**.

:::note
You can manage device enrollment permissions later in **Team & Resources** > **Devices**.
:::

## Step 5: Complete WARP setup

On your device, complete the WARP installation wizard. Then connect WARP to your Zero Trust organization. For comprehensive OS-specific instructions, refer to [Manual deployment](/cloudflare-one/team-and-resources/devices/warp/deployment/manual-deployment/).

1. Open the WARP client. On macOS, select the Cloudflare icon in your status bar. On Windows, select the Cloudflare icon in your system tray.
2. Go to **Preferences** > **Account** > **Login to Cloudflare Zero Trust**.
3. Enter your team name when prompted. Your team name is the unique identifier for your Zero Trust organization and was set when the organization was created. The dashboard displays your team name on this screen for easy reference.

:::note
To find or change your team name, go to **Settings** > **Team name** and select **Edit**.
:::

4. Complete the authentication steps.
5. The WARP client should show as **Connected**.
6. Select **Continue** in the dashboard.

## Step 6: Verify your connection

The dashboard confirms that you are securely connected. You now have remote access between your device and your private network resources.

To verify connectivity, try reaching a resource on your private network (for example, `http://10.0.1.100` or `ssh 10.0.1.50`).

## Recommended next steps

After verifying your connection, consider securing your private network with policies and access controls:

- **Set up Gateway policies**: By default, all enrolled devices can reach your entire private network. Gateway policies let you inspect traffic and control access based on user identity and network attributes. For more information, refer to [DNS policies](/cloudflare-one/traffic-policies/dns-policies/) and [Network policies](/cloudflare-one/traffic-policies/network-policies/).
- **Create an Access application**: Restrict access to specific applications or hostnames on your private network with identity-based rules. For more information, refer to [Secure a private IP or hostname](/cloudflare-one/access-controls/applications/non-http/self-hosted-private-app/).
- **Explore more with Zero Trust**: Review your tunnel, policies, and connected devices in the [Cloudflare One dashboard](https://one.dash.cloudflare.com).

For in-depth guidance on policy design and device posture checks, refer to the [Replace your VPN learning path](/learning-paths/replace-vpn/concepts/).

## Troubleshoot

If you have issues connecting, refer to these resources:

- [Troubleshoot WARP](/cloudflare-one/team-and-resources/devices/warp/troubleshooting/): resolve WARP client connection and enrollment issues.
- [Troubleshoot tunnels](/cloudflare-one/networks/connectors/cloudflare-tunnel/troubleshoot-tunnels/): diagnose tunnel connectivity and routing problems.
31 changes: 31 additions & 0 deletions src/content/docs/cloudflare-one/setup/replace-vpn/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
pcx_content_type: navigation
title: Replace your VPN
sidebar:
order: 1
description: Replace your traditional VPN with Cloudflare Zero Trust. Choose a connection scenario to get started.
---

import { CardGrid, LinkTitleCard } from "~/components";

Cloudflare One uses Cloudflare's global network and Zero Trust Network Access (ZTNA) to replace traditional VPNs. After you securely connect your devices and resources to Cloudflare, you can set policies to verify every request based on identity and context, reducing your attack surface and improving performance for remote users. For more background, refer to [Why should you replace your VPN?](/learning-paths/replace-vpn/concepts/why-vpn/)

How you set this up depends on what needs to connect to what. Choose the scenario that matches your use case:

<CardGrid>

<LinkTitleCard
title="Device to network"
href="/cloudflare-one/setup/replace-vpn/device-to-network/"
icon="laptop"
>
Connect remote users to internal applications and services through a secure
connection. Best for remote access to private networks.
</LinkTitleCard>

</CardGrid>

:::note

For in-depth guidance on policy design and device posture checks, refer to the [Replace your VPN learning path](/learning-paths/replace-vpn/concepts/).
Comment on lines +28 to +30

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
:::note
For in-depth guidance on policy design and device posture checks, refer to the [Replace your VPN learning path](/learning-paths/replace-vpn/concepts/).
:::note
For in-depth guidance on policy design and device posture checks, refer to the [Replace your VPN learning path](/learning-paths/replace-vpn/concepts/).

:::
Loading