1. Download Happ

Happ is our recommended client for macOS. It supports Apple Silicon (M1/M2/M3) and Intel Macs.

Download options:

After downloading, open the .dmg file.

Happ download page showing macOS download button

2. Install the app

  1. Open the downloaded .dmg file
  2. Drag the Happ icon into your Applications folder
  3. Open Happ from Applications
  4. If macOS warns you that the app is from an unidentified developer, go to System Settings → Privacy & Security and click Open Anyway

You may need to enter your Mac password to confirm.

macOS security warning with Open Anyway button

3. Allow the system extension

When you first connect, macOS will ask you to allow a system network extension:

  1. Click Open System Settings
  2. Under VPN & Filters, toggle Happ to Allowed
  3. You may need to restart the app

This step is required for Happ to create a VPN tunnel.

macOS system extension permission dialog

4. 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

5. Connect

  1. Return to the main screen
  2. Pick a server region from the list
  3. Click the Connect button
  4. Wait for the status to change to Connected

You are now protected. Happ adds a menu bar icon so you can connect and disconnect with one click.

Happ main screen showing Connect button

1. Download v2RayTun

v2RayTun is an alternative client for macOS.

Download options:

After downloading from the App Store, the app installs automatically.

App Store page for v2RayTun

2. Open the app

  1. Open v2RayTun from your Applications folder or Launchpad
  2. If macOS warns you, go to System Settings → Privacy & Security and click Open Anyway
macOS security warning for v2RayTun

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. macOS will ask you to allow VPN configuration — click Allow

You are now protected.

v2RayTun main screen with Connect button

Tips

  • Menu bar icon: Both apps add a menu bar icon for quick connect/disconnect
  • Auto-connect: Enable auto-connect in the app settings so it reconnects when you switch Wi-Fi networks
  • Shortcuts: You can add a keyboard shortcut or Siri Shortcut to connect with a keypress

Troubleshooting

  • “App cant open”: Right-click the app and choose Open, then confirm in System Settings
  • “System extension blocked”: Go to System Settings → Privacy & Security → Extensions → Network Extensions and enable the app
  • “Failed to bind”: Quit other VPN apps that may be holding the network interface
  • “Subscription not loading”: Check that your subscription link is still active in your dashboard