Linux
Linux Setup Guide
This guide walks you through connecting your Linux system to CompassVPN using a free graphical client app.
Prerequisites
Before you begin, you’ll need:
- A configuration link from your CompassVPN server
- A Linux distribution (Ubuntu, Debian, Arch, Fedora, etc.)
- Basic terminal knowledge might be required for installation depending on the client and distribution.
Step 1: Choose and Install a Client
We recommend one of the following clients for Linux:
v2rayA: A client with a web-based interface that runs as a background service.
- Follow the official installation guide for your distribution (APT source, AUR, Docker, Snap, or direct downloads).
- Releases: latest v2rayA release on GitHub.
Furious: A desktop app.
- Open the latest Furious release on GitHub and follow the installation instructions in the repository’s README (also installable via PyPI).
Depending on the client and your distribution, you may need to install Xray-core separately, or the client might handle it for you.
Step 2: Import Configuration
- Open the client application you installed (v2rayA usually runs as a service accessed via
http://localhost:2017, while Furious is a standard desktop app) - Copy the configuration link provided by your CompassVPN server
- Look for an “Import”, “Add”, or “+” button within the client’s interface
- Choose the option to import from clipboard or URL
- Paste the link when prompted
- The CompassVPN configuration should now appear in your list of servers or connections
Step 3: Connect to CompassVPN
- Select the newly imported CompassVPN configuration in your client
- Click the “Connect” or similar button to establish the VPN connection
Step 4: Test Your Connection
- Once connected, open your web browser
- Visit browserleaks.com/ip
- Verify that your IP address has changed to the VPN server’s IP