1. Download Happ

Happ is our recommended client for Linux. It is available as a .deb, .rpm, or .pkg.tar.zst package.

Download options:

Pick the package that matches your distribution.

Happ download page showing Linux package options

2. Install the app

For Debian/Ubuntu (.deb):

sudo dpkg -i Happ.linux.x64.deb
sudo apt-get install -f

For Fedora (.rpm):

sudo rpm -i Happ.linux.x64.rpm

For Arch (.pkg.tar.zst):

sudo pacman -U Happ.linux.x64.pkg.tar.zst

After installation, you can launch Happ from your app menu or by typing happ in the terminal.

Terminal showing Happ installation commands

3. Add your subscription

  1. Open Happ
  2. Click Settings (gear icon)
  3. Go to the Subscription tab
  4. Click Add from URL
  5. Paste your SericaVPN subscription link (copy it from your dashboard)
  6. Click Add, then click Update
Happ subscription settings on Linux

4. Connect

  1. Return to the main screen
  2. Pick a server region from the list
  3. Click the Connect button
  4. The app will ask for your sudo password to set up network routing — enter it when prompted

You are now protected.

Happ main screen on Linux showing Connect button

1. Download v2RayTun

v2RayTun is an alternative client for Linux.

Download options:

After downloading, open the package file.

v2RayTun download page showing Linux option

2. Install the app

Follow the installation instructions for your distribution. Most Linux packages can be installed with your package manager.

Terminal showing v2RayTun installation

3. Add your subscription

  1. Open v2RayTun
  2. Click Subscription at the top
  3. Paste your SericaVPN subscription link (copy it from your dashboard)
  4. Click Update
v2RayTun subscription settings

4. Connect

  1. Pick a server from the list
  2. Click the Connect button
  3. Enter your sudo password if prompted

You are now protected.

v2RayTun main screen with Connect button

1. Download v2rayN

v2rayN is a popular open-source client with extensive protocol support.

Download options:

After downloading, extract the archive.

v2rayN GitHub releases page

2. Run the app

  1. Extract the downloaded archive
  2. Open a terminal in the extracted folder
  3. Make the binary executable:
chmod +x v2rayN
  1. Launch the app:
./v2rayN
Terminal showing v2rayN launch commands

3. Add your subscription

  1. Open v2rayN
  2. Go to Subscription → Add
  3. Paste your SericaVPN subscription link (copy it from your dashboard)
  4. Click OK, then go to Subscription → Update
v2rayN subscription dialog

4. Connect

  1. Pick a server from the list
  2. Right-click the server and choose Connect
  3. The app will route your traffic through the selected server

You are now protected.

v2rayN server list with right-click menu

Tips

  • Auto-start: Add the app to your startup applications so it opens after reboot
  • System tray: Both apps support system tray icons for quick access
  • Terminal launch: You can also launch Happ from the terminal by typing happ

Troubleshooting

  • “App wont open”: Make sure the binary is executable (chmod +x)
  • “No internet after connecting”: Try a different server from the list
  • “Subscription not loading”: Check that your subscription link is still active in your dashboard
  • “Permission denied”: Run the app with sudo or add your user to the network group