v2rayN on Linux: Setup Guide

v2rayN has an official Linux version with a graphical interface, and the Xray and sing-box cores are bundled inside the package.

Supported distributions (according to the project Wiki): Debian 12+, Ubuntu 22.04+, Fedora 36+, Red Hat 9+ Prerequisite: a config link or subscription from your service provider.

Step 1: Download from the official source

Open the latest stable release (7.25.4 at the time of writing) on github.com/2dust/v2rayN/releases.

Each file has a .sig file for signature verification. If you wish, check its authenticity before installing.

Step 2: Installation

Debian / Ubuntu:

bash sudo apt install -y ./v2rayN-linux-64.deb

Fedora / Red Hat:

bash sudo dnf install -y ./v2rayN-linux-rhel-x64.rpm

Zip version (portable):

bash unzip v2rayN-linux-64.zip -d v2rayN cd v2rayN chmod +x v2rayN ./v2rayN

The deb/rpm versions store their files in the user's standard paths. The zip version keeps everything next to itself.

Step 3: Running

• After installing the deb or rpm, launch the app from the applications menu or with the v2rayN command in a terminal.
• If you want to use TUN mode, the app needs root access.

Step 4: Adding a config

1. Copy the vless://... link.
2. Press Ctrl+V in the app window, or choose add from clipboard from the Servers menu.
3. For a subscription, create a group with the subscription URL in Subscription group setting and update it.

Step 5: Connecting

1. Double-click the server.
2. Choose System proxy or TUN mode.
3. If you use System proxy, make sure your desktop environment (GNOME, KDE and so on) respects the system proxy settings. Otherwise you can set the app's local proxy (for example SOCKS on 127.0.0.1) directly in the browser or app. See the exact port in the app settings.

Step 6: Testing

• Check your IP on a test site.
• Check for DNS and IPv6 leaks.

Alternatives on Linux

Troubleshooting common problems

Questions? BlendIn VPN support can help you.