← Cloudflare WARP client / warp-client / get-started

Linux

You have two ways of installing WARP on Linux, depending on the distro you are using:

• Find the latest WARP client in the package repository ↗.
• Install the cloudflare-warp package that suits your distro:
  • apt-based OS (like Ubuntu): sudo apt install cloudflare-warp.
  • yum-based OS (like CentOS or RHEL): sudo yum install cloudflare-warp.

The command line interface is the primary way to use WARP.

To connect for the very first time:

1. Register the client warp-cli registration new.
2. Connect warp-cli connect.
3. Run curl https://www.cloudflare.com/cdn-cgi/trace and verify that warp=on.

You can use warp-cli mode --help to get a list of modes to switch between. For example:

• DNS only mode via DoH: warp-cli mode doh
• WARP with DoH: warp-cli mode warp+doh

You can switch the protocol that WARP uses to route traffic from the device to Cloudflare.

• WireGuard: warp-cli tunnel protocol set WireGuard
• MASQUE: (default) warp-cli tunnel protocol set MASQUE

For information on WireGuard versus MASQUE, refer to our blog post ↗.

The Linux client supports all 1.1.1.1 for Families modes, in either WARP on DNS-only mode:

• Families mode off: warp-cli dns families off
• Malware protection: warp-cli dns families malware
• Malware and adult content: warp-cli dns families full

To enable WARP+ Unlimited on Linux, you will need an iOS or Android device that has an existing WARP+ Unlimited subscription.

1. On your iOS or Android device, launch the 1.1.1.1 Faster Internet app.

2. Go to Settings > Account and copy the Key value.

3. On your Linux device, run the following command:

   warp-cli registration license <KEY>

4. Verify the new registration:

   warp-cli registration show

   Account type: Unlimited
   ...

Your WARP+ Unlimited subscription is now active on this device.

A complete list of all supported commands can be found by running:

warp-cli --help

You can find logs required to debug WARP issues by running sudo warp-diag. This will place a warp-debugging-info.zip file in the path from which you ran the command.

To report bugs or provide feedback to the team use the command sudo warp-diag feedback. This will submit a support ticket.