← All articles

What is a VLESS key and how to import it into Happ or v2rayTun

Setup · October 27, 2026 · Updated November 18, 2026 · 3 min read · 404 VPN team

A VLESS key is a single link that starts with vless:// and contains everything a client app needs: the server address and port, your personal UUID, and the transport parameters such as Reality's public key and SNI. You never edit it; you copy it from your dashboard and import it into the app by clipboard or QR code. In the 404 VPN apps you do not need keys at all: you sign in and the app fetches them. Import takes ten seconds. If it fails, it is almost always because a chat app changed a character.

Anatomy of a key

vless://<uuid>@<host>:<port>?security=reality&sni=<site>&pbk=<public key>&sid=<short id>&fp=chrome&flow=xtls-rprx-vision&type=tcp#404 VPN
PartMeaning
uuidyour identity on the server; treat it like a password
host:portthe server and its port; WebSocket entries use 443
security=realitythe transport is Reality; other keys say tls or none
snithe public site the handshake imitates; must match the server
pbk, sidReality public key and short ID; must match the server
fp=chromewhich browser fingerprint the client mimics
flow=xtls-rprx-visionthe Vision flow that removes the TLS-in-TLS pattern
typetcp for Reality, ws for WebSocket, xhttp for XHTTP
#namea label the app shows

A WebSocket entry has security=tls, type=ws and a path instead of pbk and sid.

The dashboard gives you both. A single key is one server with one transport. The subscription link is an https:// address that returns all your keys, and the app refreshes it on its own, so new servers and transports appear without re-importing. Use the subscription link unless you want to pin a specific entry. Details in subscription link vs single key.

How to import

  1. In the dashboard open the keys page, choose a server and copy its key, or leave the QR code on screen. For the subscription link use the VPN tab.
  2. Open the app and tap the plus button.
  3. Choose Import from clipboard, or Scan QR if the key is on another screen.
  4. The entry appears in the list with the label from the key. Tap it, press Connect.

Platform guides: iPhone and iPad, Android, macOS, Windows.

When the import fails

Keep the key private

Anyone with the key can use your account's traffic and device slots. Do not post it in public chats or screenshots. If it leaks, write to help@404vpn.io from the account email and we reissue it: the old key stops working and every device needs the new one.

FAQ

Is a VLESS key the same as a config file?

A key is one line; a config file is the JSON that Xray or sing-box reads on a server or router. The apps turn the key into a config for you. For routers you write the config by hand; see the OpenWrt guide.

Can I use one key on several devices?

Yes, up to the number of devices on your plan, from 1 to 8.

Why does the key have a # and a name at the end?

That is the label the app displays. You can rename it in the app without affecting the connection.

Can I generate my own key?

No. The UUID must exist on the server. Keys come from the dashboard only.