Clash Verge on Linux: Install & Configure (Ubuntu / Debian / Fedora / Arch)
“How to configure Clash Verge on Linux” is a common question. This guide covers installation per distro, then first-time setup and the Linux-specific gotchas (TUN authorization, GNOME tray).
On Linux today you install Clash Verge Rev (Mihomo kernel).
1. Install per distro #
First download the package for your architecture (x86_64/amd64 or aarch64/arm64) from the download page or GitHub Releases.
Ubuntu / Debian (.deb) #
# recommended: apt resolves dependencies
sudo apt install ./Clash.Verge_*_amd64.deb
# or
sudo dpkg -i ./Clash.Verge_*_amd64.deb && sudo apt -f install
Fedora / RHEL / openSUSE (.rpm) #
sudo dnf install ./Clash.Verge-*.x86_64.rpm
# or
sudo rpm -i ./Clash.Verge-*.x86_64.rpm
Arch / Manjaro (AUR) #
yay -S clash-verge-rev-bin
Then launch “Clash Verge” from your app menu, or run clash-verge in a terminal.
2. First-time setup (import subscription → pick node → enable proxy) #
- Open Profiles → New → paste your subscription URL → download.
- Go to Proxies and pick a node; test latency first (204 test URLs).
- Back on the home screen, turn on System Proxy — your browser now uses the proxy.
- For custom rules (force a site direct/proxy/block), see adding rules.
3. TUN mode and privileges (the Linux key point) #
System proxy only covers apps that honor proxy settings; for whole-machine proxying (CLI tools and apps that ignore the system proxy) enable TUN, which needs elevated privileges:
- In Settings → Service Mode / authorize the core, follow the prompt and enter your sudo password to grant the core privileges.
- Some distros require setting capabilities (
setcap) on the core binary. - Then toggle TUN Mode on.
Full details: Clash Verge TUN mode setup.
4. Common Linux issues #
| Symptom | Cause / fix |
|---|---|
| No tray icon on GNOME | GNOME hides tray icons → install & enable the “AppIndicator and KStatusNotifierItem Support” extension |
| TUN won’t enable / no internet | Core not authorized → install Service Mode / authorize; then check DNS is on |
| White screen on launch | Missing WebKitGTK runtime → install webkit2gtk for your distro (e.g. libwebkit2gtk-4.1) |
| .deb dependency errors | Use sudo apt install ./xxx.deb so apt resolves deps, not dpkg alone |
| Doesn’t start on boot | Enable “launch on boot” in settings, or add it to your DE’s autostart |
Related #
- All-platform installers: Clash Verge download page
- Whole-machine proxy: Clash Verge TUN mode setup
- Add custom rules: How to add rules in Clash Verge
- Override DNS/ports: Clash Verge Global Extended Configuration
- Versions: Clash Verge Rev vs the original