Documentation · For users

Subscriptions

How to add your provider's subscription to FlowLock, what the subscription card shows, HWID, and subscriptions from limited links.

A subscription is the link your VPN provider gave you (usually https://… from their dashboard or bot). FlowLock downloads the servers, routing rules, traffic and expiry date from it by itself.

Add a subscription

Copy the link and paste it into FlowLock: the add button in the subscriptions section, or “Add from clipboard” in the tray menu / menu bar.
Or open a flowlock://add/… link, if your provider put an “Add to FlowLock” button on their page: the app asks for confirmation.
Or open your provider's limited link https://flowlock.cc/i/…: the page opens FlowLock.

FlowLock understands subscriptions from Remnawave, Marzban, 3x-ui and compatible panels: base64 and link lists, Xray JSON, sing-box JSON. Single servers (vless://, hysteria2://, trojan://, ss://, vmess://, WireGuard and AmneziaWG .conf, OpenVPN .ovpn) can be added the same way: they go to “My servers”.

What a subscription shows

name, traffic and expiry, if the panel reports them (“unlimited”, “Expired”);
the “Support” and “Subscription page” buttons, and the provider's announcement;
for verified providers: their contacts, info block and renewal reminder.

Subscriptions refresh by themselves (the panel suggests how often) and are downloaded directly, outside the VPN: many panels don't answer requests from VPN server addresses.

HWID

Many panels limit the number of devices by HWID. FlowLock sends it in the x-hwid, x-device-os, x-ver-os, x-device-model headers while “Send HWID” is on; for a single subscription the HWID can be set by hand. If the provider requires the HWID always, FlowLock says so: “required by the provider”.

Subscription from a limited link

A provider can give you a subscription link with a device limit. FlowLock adds such a subscription but doesn't show its address: it can't be copied or sent to a friend. On your second device add the same link, and it will take another place.

Provider notifications

The provider of a verified subscription can send a notification (for example, about maintenance) or ask the app to refresh the subscription. Import offers always wait for your “Add”, and settings changed by the provider are marked “Set by the provider” with a “Restore mine” button. All of this is turned off with the “Tell the provider I'm connected” setting.

This page in Markdown · Every page is available as Markdown: add .md to its address without the trailing slash. The list is in llms.txt, everything at once in llms-full.txt.