🧰 Requirements

Make sure you have:

  • A working internet connection
  • networkmanager and systemd installed (default on most systems)

✅ Step 1: Install Required Packages

🐧 For Arch Linux:

sudo pacman -S wireguard-tools wireguard-dkms networkmanager networkmanager-wireguard curl

🐧 For Debian/Ubuntu/Kali/Parrot:

sudo apt update -y
sudo apt install wireguard resolvconf curl -y

⚠️ If networkmanager is missing:

sudo apt install network-manager

🛠️ Step 2: Install wgcf (WARP Config Generator)

🐧 For Arch Linux:

sudo pacman -S wgcf

🐧 For Debian-based distros:

Download from wgcf GitHub Releases Then:

chmod +x wgcf_*_linux_amd64
sudo mv -v wgcf_*_linux_amd64 /usr/bin/wgcf

📦 Step 3: Register WARP Account

wgcf register

This creates wgcf-account.toml

📄 Step 4: Generate WireGuard Config

wgcf generate

This creates wgcf-profile.conf

🪪 Step 5: Move Config to System Directory

sudo mv -v wgcf-profile.conf /etc/wireguard/

🚀 Step 6: Start and Stop WARP Tunnel

✅ Start Tunnel:

sudo wg-quick up wgcf-profile
sudo wg-quick up ./wgcf-profile.conf   ### if you are using custom file

❗ If you get:

resolvconf: signature mismatch: /etc/resolv.conf

Fix it:

sudo resolvconf -u

and run again the Start Tunnel command:

sudo wg-quick up wgcf-profile
sudo wg-quick up ./wgcf-profile.conf   ### if you are using custom file

⛔ Stop Tunnel:

sudo wg-quick down wgcf-profile
sudo wg-quick down ./wgcf-profile.conf   ### if you are using custom file

🧪 Step 7: Test If WARP is Working

curl https://www.cloudflare.com/cdn-cgi/trace

Look for:

warp=on

If you see that line, WARP VPN is active ✅

🌀 Optional: Enable Auto Start on Boot

sudo systemctl enable wg-quick@wgcf-profile

ℹ️ About This Guide

Cloudflare WARP VPN is free and gives fast reliable internet. Since Telegram is banned in Nepal and many students use it to download courses and materials, this guide helps you set up WARP on Arch Linux and Debian. If you are using any other distro, just install the same packages using your package manager or build from GitHub.