Skip to content
RayTun

Quick Start

Get a V2RayTun panel running in under five minutes with a single install command.

Prerequisites

  • A fresh VPS with Ubuntu 22.04+ or Debian 12+ (1 vCPU / 1 GB RAM minimum).
  • A domain (or two subdomains) pointed at the server's IP — one for the panel, one for subscriptions.
  • Ports 80 and 443 open.

1. Run the Installer

Bash
bash <(curl -fsSL https://raw.githubusercontent.com/v2RayTun/install-panel/main/install.sh)

The script installs Docker (if missing) and downloads the v2raytunsetup CLI.

2. Install the Panel

Bash
v2raytunsetup install-panel

The wizard asks for your panel domain and subscription domain, then pulls Docker images and starts all services.

Non-Interactive Mode

Pass domains as environment variables to skip the wizard:

Bash
V2RAYTUN_PANEL_DOMAIN=panel.example.com \
V2RAYTUN_SUB_DOMAIN=sub.example.com \
v2raytunsetup install-panel

3. Register the Admin Account

Open https://panel.example.com/register in your browser and create the first admin user. Registration is locked after the first account is created.

4. Add Your First Node

  1. Go to Nodes → Add Node in the panel.
  2. Enter a name and the node server's IP.
  3. Copy the generated docker-compose.yml and mTLS certificates.
  4. SSH into the node server, paste the files, and run docker compose up -d.

The node will appear as online in the panel within a few seconds.

5. Create Users

  1. Navigate to Users → Add User.
  2. Set a username, traffic limit, and expiry.
  3. The user automatically receives a subscription URL containing configs for all enabled protocols.

Share the subscription URL with the user — they can import it into any compatible client (e.g., v2rayNG, Streisand, AmneziaVPN, Hiddify).

What's Next?