> For the complete documentation index, see [llms.txt](https://docs.opennetvpn.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opennetvpn.com/setup-guides/macos.md).

# macOS

### Setting Up OpenNet VPN on macOS

You can connect to OpenNet VPN on macOS using modern and flexible VPN clients that support **VMess**, **VLESS**, and **Trojan** protocols. These apps offer encrypted and private tunnels that work reliably across various networks.

> 🔐 *You’ll need your OpenNet access code to begin. If you don’t have one, visit* [*opennetvpn.com*](https://opennetvpn.com) *to request a free trial or subscribe.*

***

#### Using V2Ray-Compatible Apps

Several apps for macOS provide seamless support for OpenNet VPN access codes. The most popular options are **V2RayU**, **V2Box**, and **Qv2ray**.

***

#### Option 1: V2RayU or V2Box (Recommended)

**1. Install the App**

* **V2RayU (GitHub):** [Download here](https://github.com/yanue/V2rayU/releases)
* **V2Box (App Store / GitHub):** [V2Box – GitHub](https://github.com/hossinasaadi/V2Box-Linux)

![](/files/HIXF174VJeE9ASotZ0gE)

***

**2. Import Your Access Configuration**

* Launch the app and click the **“Import”** or **“+”** button.
* Paste your OpenNet VMess/VLESS/Trojan configuration link or scan the provided QR code.

![](/files/yLwflxsK93mP9IoUEfH7)

***

**3. Connect to VPN**

* After importing, select the server from your list.
* Click **“Start”** or toggle the switch to activate the VPN.
* Optionally, enable **“Global Proxy”** to route all system traffic through the tunnel.

![](/files/VLlAf92Dks7iQiBJtMOO)

Once connected, all traffic from your Mac will be encrypted via OpenNet’s secure servers.

***

#### Option 2: Qv2ray (Advanced)

**Qv2ray** is a cross-platform V2Ray client that requires the **Xray core**.

* **Download Qv2ray:** [GitHub – Qv2ray](https://github.com/Qv2ray/Qv2ray/releases)
* Launch the app, and let it automatically install the core (Xray).
* Import your configuration link and click **Connect**.

![](/files/Ge4oWZzyN8xXrFM8Iqk2)

***

#### ⚠️ Notes

* Only one VPN app should be active at a time. Disconnect V2RayU if switching to Qv2ray, and vice versa.
* All OpenNet access codes work across all clients and protocols — try different apps if you experience network filtering or need enhanced compatibility.

With one of these macOS-compatible apps, you’ll enjoy fast, secure VPN access with full protocol flexibility.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opennetvpn.com/setup-guides/macos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.