How to use VLESS key in a client app

One link from the bot, many apps that can read it.

The key is a link, the app does the rest

A VLESS key is a text link that holds the server address and connection settings. You copy it from the Telegram bot, paste it into a client app, and the app builds the connection. How to use VLESS key links comes down to one paste, and there is no password to remember.

We ship no app ourselves. You choose a free client that understands VLESS, and any of them can read the same link.

The general routine, whichever app you use

  1. Open the Telegram bot and ask for your link. Expect the link a minute or so later.

  2. Get the client app from its developer's website or from the store on your device.

  3. Look for the menu entry that adds a subscription, or reads from the clipboard, and drop the link in.

  4. Refresh the list so the servers appear, then choose one and connect.

  5. Check your public address to confirm the connection is live.

Clients you will meet

  • v2rayNG, a common choice on Android phones and tablets.
  • Hiddify, a client that is built for several systems, including phones and computers.
  • Happ, an app with a plain interface for pasting a subscription.
  • V2Box, a client often used on iPhone.
  • Shadowrocket, Karing, sing-box, Nekobox and Streisand, which read the same style of link on their own platforms.
  • v2rayN, the Windows relative of v2rayNG.

How to pick between them

Decide by device first, then by how much you want to adjust. Some clients show only a connect button, while others expose routing and DNS fields that are easy to break. If you only want the tunnel, start with the simplest option your system offers.

Plainly, since we are a seller: these clients are free tools made by other people, we do not control them, and you should read each app's own page for what it asks permission for. Each client section on this site goes through one of them in detail.

Before you install anything

Check what your country allows before relying on any client, since the position can change.

Software wrote the first version of this page. What our editors compared with the way the bot hands out links is the list of steps. Read each client's own page before granting it any permission.

Questions

Do I need a different key for every app?

No. The same subscription link can be pasted into any compatible client, and several devices can use it together.

Why does the app show an empty server list after I paste the link?

The list usually fills once you refresh the subscription. If it stays empty, copy the link again from the bot without extra spaces.

Is VLESS an app?

No, it is the way the connection is described. The app is the client that reads that description and opens the tunnel.

What if my phone does not allow installing from outside the store?

Use an app available through your platform's store for the same protocol, or install from the developer's page if your system allows it.

Can I scan a code instead of pasting?

Many clients offer a camera import for a code that contains the same link. Pasting from the clipboard works everywhere.

What do I do when the link stops working?

Return to the bot and request a fresh one. Pay for the next period there too, since nothing renews automatically.

The bot hands you the link

Free to try and no sign-up. Try it on the network you really use.