Cloudflare Docs
Cloudflare Zero Trust
Cloudflare Docs
Cloudflare Zero Trust
GitHub icon
Edit this page on GitHub
Set theme to dark (⇧+D)
  1. Products
  2. Cloudflare Zero Trust
  3. ...
  4. ...
  5. ...
  6. User-side certificates
  7. Install certificate using WARP

Install a certificate using the WARP client

Feature availability
WARP modesZero Trust plans
All modesAll plans
SystemAvailabilityMinimum WARP version
Windows✅2023.3.381.0
macOS✅2023.3.381.0
Linux✅2023.3.381.0
iOS❌
Android❌
ChromeOS❌

The WARP client can automatically install the Cloudflare certificate (or a custom root certificate) on Windows, macOS, and Linux devices enrolled in your Zero Trust organization. On mobile devices, you will need to install the certificate manually.

The certificate is required if you want to apply HTTP policies to encrypted websites, display custom block pages, and more.

​​ Install the certificate using WARP

  1. (Optional) Upload a custom root certificate to Cloudflare.
  2. In Zero Trust, go to Settings > WARP client.
  3. Enable Install CA to system certificate store.
  4. Install the WARP client on the device.
  5. Enroll the device in your Zero Trust organization.

If a custom certificate is not provided, WARP will install the default Cloudflare certificate in the system keychain for all users. If you uploaded a custom certificate, the WARP client will deploy your custom certificate instead of the Cloudflare certificate.

Next, verify that the certificate was successfully installed.

​​ View the installed certificate

​​ Windows

  1. Open the Start menu and select Run.
  2. Enter certlm.msc.
  3. Go to Trusted Root Certification Authority > Certificates.

The default Cloudflare certificate is named Cloudflare for Teams ECC Certificate Authority.

The certificate is also placed in %ProgramData%\Cloudflare\installed_cert.pem for reference by scripts or tools.

​​ macOS

  1. Open Keychain Access.
  2. Go to System > Certificates.
  3. Double-click your certificate. (The default Cloudflare certificate is named Cloudflare for Teams ECC Certificate Authority.)
  4. You should see This certificate is marked as trusted for all users.

The certificate is also placed in /Library/Application Support/Cloudflare/installed_cert.pem for reference by scripts or tools.

​​ Linux

On Linux, the certificate is stored in /usr/local/share/ca-certificates. The default Cloudflare certificate is named managed-warp.pem.

If you do not see the certificate, run the following commands to update the system store:

  1. Go to the system certificate store.

    $ cd /usr/local/share/ca-certificates

  2. Rename the certificate, changing the file extension to .crt.

    $ sudo mv managed-warp.pem managed-warp.crt

  3. Update your list of custom CA certificates.

    $ sudo update-ca-certificates

The certificate is also placed in /var/lib/cloudflare-warp/installed_cert.pem for reference by scripts or tools.

​​ Uninstall the certificate

If the certificate was installed by the WARP client, it is automatically removed when you disable Install CA to system certificate store or uninstall WARP. WARP does not remove certificates that were installed manually (for example, certificates added to third-party applications).

To manually remove the certificate, refer to the instructions supplied by your operating system or the third-party application.