Xray quick start

The Xray module in the BeAdmin panel runs your own VPN on the server using modern protocols — VLESS, Reality, and Trojan. The traffic is masked as a regular HTTPS request to a real website — to the ISP and DPI filters it looks like normal web browsing, not a VPN. Useful where OpenVPN and WireGuard are already recognized and blocked.

This article walks through the minimum scenario: install the module, create the first user, and connect a client device.

ℹ️ Note

Your own VPN server pays off compared with commercial services: bandwidth is not split between hundreds of clients, and the traffic is indistinguishable from regular HTTPS — which lowers the risk of falling under mass blocking.

⚠️ ISP restrictions

Traffic encryption makes a VPN a reliable way to protect a connection, but in some countries and regions internet providers actively interfere with VPN protocols. Because of this, full availability of the service cannot be guaranteed — regardless of the connection type. If one protocol does not work for you, try another VPN module available in the panel. If none of them work on your network, contact support and we will issue a refund for the license.

You'll need a server with BeAdmin — our partners ship a ready-to-use VPS the moment you order.

Proven over 15 years in hosting. Your VPS with BeAdmin is ready to go out of the box.

• Germany
• Netherlands
• Sweden
• Switzerland
• Spain
• USA

Select server

European reliability made simple. Launch BeAdmin with your VPS in just one click.

• Germany
• Netherlands
• Sweden
• Estonia
• Romania
• Switzerland
• Spain
• United Kingdom
• USA

Sign up

Installing the module

In the side menu open VPN → Xray and click Install. A small dialog opens with a single field — Port, the port the module will accept connections on; the default is 8443, leave it as is unless you have a reason to change it. Click Start — the rest of the technical parameters (masquerade domain, keys) the panel generates on its own. The port and the masquerade domain can be changed later too — see Xray. Managing the module.

When installation finishes, the panel takes you straight to the Users page — the module's main screen. Installation usually takes a few minutes; you can follow the progress via the Log button on the install card.

After installation

The page header exposes the core module actions — start, stop, and restart. The three-dot menu groups the rest: Logs, update check and run, reinstall, and uninstall.

To get started, create the first user.

Creating the first user

An Xray user is a separate account with its own identifier and connection link. We recommend creating a separate user per device that will connect: that way you can revoke access for a single device without touching the others.

1. On the Users page click Create user.
2. Fill in the fields:
   • Email — the user's unique identifier. Any valid address works — a real one (you can then send the connection link to it) or a service address. The only requirement is that each user has their own.
   • Name — a free-form label: for example, "Anna's iPhone" or "work laptop". Helps you navigate the list.
   • User language — the language of the email with the connection link. Default — English.
3. Leave the Mode field on Single-hop — that's a regular user with a direct connection, exactly what the simple scenario needs. The other value, Multi-hop, links two BeAdmin installs into an entry → exit chain — a separate scenario, see Xray. Multi-hop mode.
4. By default the user is created enabled — turn off the Enabled toggle in the dialog footer if you want to create it disabled.
5. Click Create.

The user appears in the list. The server generates the connection string and a QR code — you can grab them right away. If you enter an address that already belongs to another user, an error is highlighted under the field and the form can't be saved.

ℹ️ Limit on the free plan

The free licence allows one Xray user — enough to try the service out and see whether it fits. When you need more, purchase additional slots. Details — in Xray. Managing users.

Connecting a client device

Xray uses links of the form vless://… — a compact string with connection parameters. Any Xray-compatible client accepts it via QR code scan or paste from the clipboard. A .conf file is not used.

Any of these apps will work:

• v2rayN — Windows. Imports from the clipboard.
• v2box — iOS, macOS. QR scan or link paste.
• Hiddify — Android, iOS. QR scan or link import.
• Streisand — iOS. QR scan straight from the camera.
• NapsternetV — Android.

Install one of the apps on the device that will route its traffic through the VPN.

1. In the users list click a row — a panel with the QR code and action buttons expands.
2. In the expanded row you have:
   • QR code — contains the same vless://… string as the link button.
   • Link button — copies the vless://… string to the clipboard. Useful when the device you're setting up the VPN on is the same one the panel is open on: you paste the link into the client without a camera.
   • QR code button — downloads the QR code as an image. Handy for forwarding to someone else or saving for later.
   • Email button — sends the connection link to the address set when the user was created (if SMTP is configured in the panel).
3. Import the configuration into the app:
   • On a smartphone: in the app choose import via QR code and scan the QR straight from the panel screen or from the downloaded image.
   • On a computer: copy the link with the Link button and paste it into the client (usually a menu item "Import from clipboard"). If the client has a camera or can open a screenshot, the QR code works too.
4. Activate the VPN in the app. On iOS, confirm the system prompt to install the VPN profile.

To confirm the VPN is working, open any IP-check page in your browser, for example myip.com. If everything is set up right, it will show your server's country.

Emailing the configuration

If SMTP is configured in the panel, you can send the connection link to the user by email — useful when the device isn't on hand.

In the expanded user row click Email. The link goes to the address set when the user was created.

ℹ️ If SMTP is not configured

The email button stays disabled, and the expanded row shows the note "Email sending is not configured on the server" with a link to the settings. Details — in How to set up an SMTP relay for sending emails.

What's next

• Xray. Managing users — adding users, editing, emailing the link, purchasing slots beyond the free quota.
• Xray. Managing the module — starting and stopping the service, updating, and uninstalling the module.