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

# Installing on macOS

{% hint style="info" %}
**Before you start**

* macOS 12 (Monterey) or newer
* An active Sirin subscription — see [Quick Start](/getting-started/quick-start.md)
* Your subscription QR + link from [@getsirin\_bot](https://t.me/getsirin_bot)
  {% endhint %}

## Pick your app

Sirin hands you **all four protocols in one subscription**. No single macOS app speaks all of them, so pick by what you need — most people start with AmneziaVPN.

{% tabs %}
{% tab title="AmneziaVPN (recommended)" %}
Best for **WireGuard + AmneziaWG** — the protocols that survive the heaviest filtering. This is the QR the bot shows first (the `vpn://` one).

{% stepper %}
{% step %}

### Install AmneziaVPN

Download the `.dmg` from [amnezia.org](https://amnezia.org), open it, and drag the app into **Applications**.

On first launch macOS may ask: *"Are you sure you want to open an application downloaded from the internet?"* — click **Open**.
{% endstep %}

{% step %}

### Allow the VPN

AmneziaVPN asks permission to install a system VPN configuration. Enter your admin password.
{% endstep %}

{% step %}

### Import your Sirin key

Open [@getsirin\_bot](https://t.me/getsirin_bot) in Telegram (desktop) and find the **AmneziaVPN** entry (the `vpn://` one). Copy the link, then in AmneziaVPN choose **+ → Paste from clipboard**.

*Prefer the camera? In AmneziaVPN choose **+ → Scan QR** and hold your phone showing the bot's `vpn://` QR up to the Mac's camera.*
{% endstep %}

{% step %}

### Connect

Click the big connect button. Connection takes 1–3 seconds. To try a different protocol or server later, switch in the app — it's a one-tap change.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Hiddify / Sing-Box (for VLESS + Shadowsocks)" %}
Best for **VLESS + Reality** and **Shadowsocks** — fast, low-profile protocols. Use the **subscription-link QR** (the `https://sub.sirin.one/…` one), not the `vpn://` one. On desktop, **Hiddify and Sing-Box are equally fine** — pick either.

{% stepper %}
{% step %}

### Install Hiddify or Sing-Box

Download Hiddify (or Sing-Box) for macOS from its official site, or use the link on [sirin.one](https://sirin.one). Open the `.dmg` and drag the app into **Applications**.
{% endstep %}

{% step %}

### Import the subscription

In the app choose **Add profile → from clipboard** and paste the `https://sub.sirin.one/…` link (or scan the bot's **subscription** QR). It pulls in VLESS + Shadowsocks and refreshes the server list on its own.
{% endstep %}

{% step %}

### Connect

Click connect, approve the VPN configuration when macOS asks, and you're online.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

## Verify it's working

Open Safari and visit [icanhazip.com](https://icanhazip.com). The IP should be Sirin's server — not your home network's.

{% hint style="success" %}
Want to confirm your region looks right too? Any "what's my IP" site will show the country your traffic exits from.
{% endhint %}

<details>

<summary>Other clients (only if you know what you're doing)</summary>

* **Official WireGuard app** (Mac App Store) — WireGuard only; can't import VLESS or Shadowsocks. The bot can hand you an on-demand `.conf` for the WG profile.
* **Sing-Box** — a solid alternative to Hiddify for VLESS + Shadowsocks on the desktop.

These are single-protocol or power-user tools — for the full Sirin bundle on macOS, stick with AmneziaVPN and/or Hiddify above.

</details>

## If it doesn't work

* **macOS blocks launch** — System Settings → Privacy & Security → **Open Anyway**.
* **QR won't scan** — copy the link from Telegram Desktop and paste it instead.
* **Can't connect on one protocol** — switch to another (that's the whole point of having four). VLESS/Shadowsocks live in Hiddify or Sing-Box; WireGuard/AmneziaWG in AmneziaVPN.
* **Still stuck** — see [Troubleshooting](/support/troubleshooting.md), or send `/support` in the bot.

{% content-ref url="/pages/NM8kLBLAERCsCUcqLVjp" %}
[Quick Start](/getting-started/quick-start.md)
{% endcontent-ref %}

{% content-ref url="/pages/GxX4TylGUkYZKStpQfFQ" %}
[Troubleshooting](/support/troubleshooting.md)
{% endcontent-ref %}

{% hint style="warning" %}
Trying to import the **VLESS** key directly into **AmneziaVPN**? It can be unreliable right now — use **Hiddify** (or Sing-Box) for VLESS + Shadowsocks, and keep AmneziaVPN for WireGuard + AmneziaWG.
{% endhint %}


---

# 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.sirin.one/installation/installing-on-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.