Quick Start in 30 Seconds

Download

Download AppImage file

Permissions

chmod +x to grant execution

Run & Use

Run directly, import and connect

System Requirements

Kernel

Linux 3.2 or higher

Architecture

x86_64 (amd64)

Step 1: Choose Installation Method

Use the English Hiddify Download Center to find the available Linux packages before choosing a method below.

Ubuntu / Debian / Deepin

# Install after downloading .deb
sudo apt install ./hiddify-next_*.deb
# OR
sudo dpkg -i hiddify-next_*.deb && sudo apt install -f

CentOS / Fedora / OpenSUSE

# Install after downloading .rpm
sudo rpm -ivh hiddify-next-*.rpm
# OR using dnf/yum
sudo dnf install hiddify-next-*.rpm

Step 2: Import Configuration

For token safety and profile update guidance, review how to import a Hiddify subscription safely.

Step 3: Connect and Use

Select Node: Run All Delay Test and choose a low-latency node.
Connect: Click the connection button.
Authorize: Linux VPN features require authorization; you may be prompted for sudo password or PolicyKit auth.

Success

Connected! Verify connection by running curl -I https://www.google.com in terminal (Requires TUN Mode enabled or shell proxy vars set).

Advanced Configuration

System Proxy (GNOME/KDE)

If you don't need TUN mode and only want browser proxy:

GNOME: Settings > Network > Network Proxy > Manual > Enter 127.0.0.1 and the Mixed Port shown in Hiddify settings (currently usually 12334)
KDE: System Settings > Network > Proxy > Manual

Note: Hiddify Next usually sets this automatically when System Proxy mode is on.

TUN Mode & Permissions

Enable TUN mode to proxy all traffic (including terminal).

If it fails, check if user is in network group, or try running as admin:

sudo ./HiddifyNext-*.AppImage --no-sandbox

Missing FUSE library (AppImage fails)

Ubuntu 22.04+ may require libfuse2:

sudo apt install libfuse2

FAQ

How to auto-start?

For AppImage, check "Start on Boot" in settings. If not working, manually create a `.desktop` file in `~/.config/autostart/`.

Terminal not proxying?

Even with System Proxy on, terminal apps often ignore it unless `http_proxy` var is set. Solutions: 1. Enable TUN Mode (Recommended). 2. Manually set env vars: `export all_proxy=socks5://127.0.0.1:12334` (replace 12334 with the actual Mixed Port shown in settings).

For more Linux setup and connection answers, visit the Hiddify FAQ.

How to Install and Configure Hiddify on Linux