warp-cli is the official command-line tool for managing the Cloudflare WARP service, allowing you to easily connect to the Cloudflare network for enhanced privacy and security.
- Easy connection and disconnection to Cloudflare WARP
- Supports WARP, WARP+, and DNS over HTTPS (DoH) modes
- Management of WARP+ license keys
- Checking connection status and IP address information
- Ability to enable "always-on" mode
- Automatic startup of the WARP service upon system boot
# Install an AUR helper (e.g., yay), if you don't have one
sudo pacman -S git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
cd ..
rm -rf yay
# Install warp-cli
yay -S cloudflare-warp-bincurl https://pkg.cloudflareclient.com/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflare-client.list
sudo apt update
sudo apt install cloudflare-warpAfter installation, you need to start the warp-svc service and enable it to run automatically on system startup:
sudo systemctl start warp-svc
sudo systemctl enable warp-svcwarp-cli registration newwarp-cli connectwarp-cli disconnectwarp-cli status| Command | Action |
|---|---|
warp-cli status |
Show current WARP status |
warp-cli connect |
Connect to the WARP service |
warp-cli disconnect |
Disconnect from the WARP service |
warp-cli registration new |
Register a new device |
warp-cli registration license <KEY> |
Set WARP+ license key |
warp-cli enable-always-on |
Enable "always-on" mode |
warp-cli disable-always-on |
Disable "always-on" mode |
warp-cli mode warp |
Switch to WARP mode |
warp-cli mode doh |
Switch to DNS over HTTPS mode |
warp-cli mode warp+doh |
Switch to WARP with DoH mode |
warp-cli help |
Show help for commands |
If you have a WARP+ license key, you can add it to access additional benefits:
warp-cli registration license YOUR_LICENSE_KEY_HEREYou can configure the WARP operating mode according to your needs:
# WARP only (standard mode)
warp-cli mode warp
# DNS over HTTPS only (secure DNS queries without full tunneling)
warp-cli mode doh
# WARP with DNS over HTTPS
warp-cli mode warp+doh-
Checking your external IP address: To verify if WARP is working and changing your IP, use:
curl https://www.cloudflare.com/cdn-cgi/trace/
In the output, you should see
warp=onandloc=(Cloudflare server location). -
Managing via system services: If you need more detailed control over
warp-svc, usesystemctl:sudo systemctl status warp-svc # Check service status sudo systemctl restart warp-svc # Restart the service
- Cloudflare WARP Website: https://cloudflarewarp.com/
- Cloudflare WARP Documentation: https://developers.cloudflare.com/warp/
warp-cliHelp:warp-cli help