---
title: Linux desktop client · Cloudflare WARP client docs
description: You have two ways of installing WARP on Linux, depending on the distro you are using:
lastUpdated: 2025-02-27T15:17:42.000Z
source_url:
  html: https://a74404c8.preview.developers.cloudflare.com/warp-client/get-started/linux/index.md
  md: https://a74404c8.preview.developers.cloudflare.com/warp-client/get-started/linux/
---

Consumer WARP

This documentation is for the consumer version of WARP. If you are using WARP with Cloudflare Zero Trust, refer to the [Zero Trust documentation](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/).

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](https://pkg.cloudflareclient.com/).

* 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`.

Note

If you get an error message when trying to install via the terminal, download the package that suits your distro from the [package repository](https://pkg.cloudflareclient.com/).

## Using WARP

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

### Initial Connection

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`.

### Switching modes

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

* **DNS only mode via DoH:** `warp-cli mode doh`.
* **WARP with DoH:** `warp-cli mode warp+doh`.

### Using 1.1.1.1 for Families

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`

### Additional commands

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

```sh
warp-cli --help
```

## Feedback

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.
