Clash Verge logo Clash VergeOpen-source cross-platform proxy client

Setup

Install Clash Verge on Linux: deb, rpm and AUR

Published · Updated · 2 min read

Linux support in Clash Verge is first-class — the deb and rpm packages come out of the same CI as the Windows and macOS builds. Match your distro:

Debian / Ubuntu family

sudo apt install ./Clash.Verge_2.5.1_amd64.deb

Use apt rather than dpkg -i so dependencies like libwebkit2gtk get pulled in automatically. On ARM boards (Raspberry Pi etc.) switch to arm64.deb or armhf.deb.

Fedora / openSUSE family

sudo dnf install ./Clash.Verge-2.5.1-1.x86_64.rpm

Arch / Manjaro

yay -S clash-verge-rev-bin

The AUR package is community-maintained and usually updated the day a release lands. Upgrades then ride along with your normal yay -Syu — the lowest-friction option long-term.

The Linux build is pixel-for-pixel the same app as on Windows and macOS
The Linux build is pixel-for-pixel the same app as on Windows and macOS

Linux-specific quirks

  • No tray icon — GNOME removed the tray. Install the AppIndicator extension (gnome-shell-extension-appindicator) and log out/in;
  • Blank window or crash on Wayland — force X11: env GDK_BACKEND=x11 clash-verge, or bake the variable into the .desktop file;
  • TUN has no permission — creating a TUN device needs root. Install service mode from Settings, or grant capabilities: sudo setcap cap_net_bind_service,cap_net_admin=+ep /usr/bin/verge-mihomo;
  • System proxy does nothing — it relies on GNOME/KDE proxy settings. On i3, Hyprland and other bare WMs, export http_proxy=http://127.0.0.1:7897 yourself.
Tip

On a headless server, skip Verge entirely — run the bare mihomo core with a web dashboard (metacubexd). The GUI adds nothing over SSH.

Don't have Clash Verge yet?

Windows 64-bit installer · v2.5.1 · free & open source

Download v2.5.1