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.

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.

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

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.

1. Download v2RayTun

v2RayTun is an alternative client for Linux.

Download options:

After downloading, open the package file.

2. Install the app

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

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

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.

1. Download v2rayN

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

Download options:

After downloading, extract the archive.

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

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

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.

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