Skip to content

Tutorial for V2Box app

This page shows you how to add your HiddifyManager subscription to the free V2Box app on iPhone and iPad, test the connections, connect, and keep your configs up to date. V2Box works with Xray-based configs.

V2Box
V2Boxv10.2.0iOS 15+FreeNov 2026

Our suggestion: the Hiddify appFree, simpler, and supports every Hiddify Manager protocolInstall →

Before you start

  • Install V2Box from the App Store. It is free.
  • Have your user page link ready. This is the link your server admin sent you. It opens your personal HiddifyManager page.

A subscription link is one link that holds all your connection settings (configs). A config is the settings for one connection to the server.

Note

The user page pictures are current (Hiddify Manager v14.5). The app screenshots come from older versions of the app; the current screens look a little different, but the steps are the same. The current screens look different, but the steps are the same.

On the user page, tap the big round button. At the bottom of the window, under Import Manually, Copy Link copies your subscription link. This app is not in the user page’s app list, so use this button.

V2Box on the user page

V2Box is not in the app list on the HiddifyManager user page, so you add the link by hand.

  1. Open your user page link.
  2. Open the menu and tap All Configs.
  3. In the Subscription Links section, find Subscription link b64 and tap Get Link. A small window opens with a QR code and a Copy Link button.

Now you can either copy the link or scan its QR code.

  1. Tap Copy Link.

    All Configs on the user page

  2. Open V2Box and tap Configs in the bottom menu.

  3. Tap the + button.

    The + button in Configs

  4. Tap Add Subscription.

  5. Type any name, for example the name of your server, and paste the link into the URL field.

    Name and URL of the subscription

  6. Tap Add Subscribe. Your configs appear in the list, and V2Box tests them by itself.

    Configs added to V2Box

Option 2: Scan the QR code

Use this if the user page is open on another screen, such as a computer.

  1. In V2Box, open Configs and tap +.
  2. Tap Scan QR.
  3. Point your phone's camera at the QR code on the user page. The configs are added and tested, just as with option 1.

Scan QR in V2Box

Test the connections

In the Configs list, tap Ping All. The result appears next to each config. Lower numbers are better; a config with an error or a timeout does not work right now.

Ping All in the Configs list

Connect

  1. In Configs, tap a config that tested well to select it.
  2. Go to Home and slide the button at the bottom to the right. The first time, iOS asks you to allow a VPN configuration; tap Allow.

The connect slider on the Home screen

While you are connected, the Home screen shows your upload, download and memory use.

Connection details on the Home screen

Update your subscription

When the admin changes something on the server, update the subscription to get the new configs:

  1. In Configs, tap +.
  2. Tap Update All Subscriptions.

Update All Subscriptions

To let V2Box update by itself, tap the menu (three lines) at the top of the Configs screen and turn on Auto Update.

Auto Update in the Configs menu

Add a single config

You can also add one config instead of the whole subscription: copy the config link, then in Configs tap + and Import V2ray URL from Clipboard. This is not recommended, because a single config is not updated when the server changes.

Import a config from the clipboard

If it doesn't connect


Last update: November 19, 2026

Comments