Documentation/Connecting/Link or subscription

Connecting with a link from a VPN service

You bought a VPN from some service, and it gave you a link, a file, or a subscription address. All of these go into one field: the app works out what it is by itself.

  1. 01

    Open “Add”

    Profiles → Add. Paste what the service gave you — a link, configuration text, or a subscription address — and press the button under the field. A file can be dragged straight into the window.

    Copied the link beforehand? The window offers to paste it from the clipboard by itself.

  2. 02

    Find the servers in Profiles

    A single link becomes a row in the list. A subscription becomes a separate group below it, with its own servers.

  3. 03

    Connect

    Click “Connect” next to the server you need — or pick it on Home and press the big button. “Fastest” measures the servers by itself and takes the best one.

What you can paste

The type is detected automatically: a line under the field says what it is, and the button says what will happen.

A server link
vless://, vmess://, trojan://, ss://, hysteria2://, tuic:// — one or several at once, each on its own line.
A subscription address
https://… from your account with the service. The app downloads the server list and keeps it up to date from then on.
The link of an “Add to…” button
Services put up buttons for Happ, Hiddify, v2RayTun, sing-box, Clash. The link of such a button works as it is — the subscription from it is added here.
A configuration or a file
[Interface] / [Peer] text from WireGuard and AmneziaWG; .conf, .ovpn and .json files. A file goes in through “Open a file” or by dragging it into the window.

How a subscription lives

  • It updates itself — The service added or removed a server — the list changes without you. How often to check is set by the service, or by you in the subscription settings; the “Refresh” button in the group header does it right away.
  • Traffic and term in plain sight — If the service reports them, the group header shows how much is used and how many days are left. The service’s announcement and links to its page and support are there too.
  • Servers belong to the subscription — A subscription’s server cannot be renamed or deleted on its own: the next refresh would bring it back. You can hide one you do not need, and the subscription is deleted as a whole — from the “⋯” menu in the header.
  • Fastest server — In the subscription menu you can add a row that picks the fastest of its servers by itself.

If something is wrong

The link is not recognized

Copy it whole, with no spaces or line breaks. An encrypted happ://crypt… link cannot be read — take the regular subscription address from your account with the service; it starts with https://.

The service mentions a device limit

Some services count devices. The app tells the service a random number for this installation — not the computer’s name. If there are no free slots, free one in your account with the service.

The subscription stopped updating

The group header will show the reason — usually the term has ended or the service changed the address. Write to the service’s support: the link to it is in the same header.

The server was added but will not connect

Links for VLESS, Trojan, Shadowsocks and the like need the sing-box or Xray module — the app offers to install it by itself. After that — Diagnostics.