macOS

System requirements

• macOS 10.13 or newer (Sierra, High Sierra, and newer)
• Intel or Apple Silicon Mac (M1, M2, M3, etc.)
• Active iCloud account (to download from App Store)
• Telegram app or web.telegram.org

Download HAPP

macOS version comes from the App Store under your iCloud account:

• Russian account: HAPP Proxy Utility Plus
• All other regions: HAPP Proxy Utility

The app is universal for both Intel and Apple Silicon Macs.

Installation

1. On your Mac, open the App Store
2. Search for “HAPP” (or click the link above)
3. Click Get then Install
4. Authenticate with your iCloud password or Apple ID
5. Wait for the download to complete
6. The app appears in Applications folder and your Dock (optionally)
7. Click Open or double-click HAPP in Applications

macOS might ask for permission to run this app on first launch — click Open.

Get your connection key

1. On your Mac (or phone), open Telegram
2. Find @SideLinQ_bot
3. Press “Connect”
4. You’ll see a long key starting with happ://crypt5/
5. Click to select the entire key, then Cmd+C to copy

Import the key into HAPP

1. HAPP is open on your Mac
2. Click the + button (or “Add Configuration”)
3. Click Paste from Clipboard
4. The app auto-detects your key and shows configuration
5. Click Save or Confirm

HAPP now shows available servers with their latency (ping). It picks the best one automatically.

Connect to the network

1. In HAPP, find the power button (⏻)
2. Click it
3. macOS asks for permission: “HAPP wants to create a VPN connection” — enter your Mac password and click OK
4. Watch the status change to Connected
5. A VPN icon may appear in your menu bar

Every app on your Mac now uses SideLinQ.

Verify it’s working

1. Open a web browser
2. Go to whatismyipaddress.com
3. Your IP should show a different country
4. Compare this to your real IP (before connecting) — they should be different

Managing your connection

Pause the connection

Click the power button (⏻) again. Your real IP becomes visible.

Reconnect

Click the power button again.

Switch servers

1. In HAPP, click the server name
2. Choose a different location
3. It reconnects automatically

Monitor connection stats

In HAPP, you can see:

• Current server and location
• Ping time (latency)
• Current upload/download speed
• Connection duration

Exit completely

Click the HAPP menu → Quit HAPP (or Cmd+Q). Your connection ends immediately.

Advanced options

Change keyboard shortcut

Some HAPP versions let you set a keyboard shortcut to toggle connection. Check HAPP preferences.

Auto-start on login

To start HAPP automatically when your Mac boots:

1. System Preferences → General → Login Items
2. Click the + and select HAPP
3. HAPP will launch whenever you log in

Troubleshooting

HAPP won’t import the key

Try these:

1. Make sure you selected and copied the entire key (starts with happ:// and ends with /)
2. Try pasting into a text editor first to verify it copied
3. Copy it again from Telegram
4. Paste into HAPP

Connected but no internet

Try this:

1. Disconnect the VPN (power button off)
2. Wait 3 seconds
3. Reconnect
4. Test a website

If still broken:

1. In HAPP, switch to a different server
2. Reconnect

Very slow speeds

This is usually a server choice issue:

1. Click the server name in HAPP
2. Notice the “ping” number for each server
3. Choose a server with lower ping (closer to you)
4. Reconnect and test again

If even the fastest server is slow, contact support.

Connection drops randomly

Causes:

• Weak WiFi — Move closer to your router
• Network switch — If you switch between WiFi and Ethernet, HAPP may disconnect. Reconnect manually.
• Sleeping Mac — When your Mac sleeps, HAPP disconnects. It resumes when you wake it up.
• HAPP is outdated — Check the App Store for updates

To prevent drops:

1. Keep WiFi/network stable
2. Keep HAPP updated
3. Don’t let your Mac sleep while using SideLinQ

It says “VPN not responding”

Try:

1. Disconnect and reconnect
2. Restart your Mac
3. Switch to a different server in HAPP
4. If it persists, check your Telegram subscription status (may have expired)

Some sites block me

Certain services (Netflix, some banks) may limit access via VPN. If this happens:

1. Try a different server (sometimes specific servers are less detected)
2. Temporarily disconnect from SideLinQ to use that service
3. Contact support if it’s a critical service

Need help? Reach out via @SideLinQ_bot or @SideLinQ_chat.