How to Install V2Ray on Ubuntu 25.04

V2Ray is a powerful open-source platform for building secure internet proxy services. It’s often used to bypass censorship or encrypt traffic using protocols like VMess. Installing it on Ubuntu 25.04 is simple if you follow the right steps.

Step 1: Update your system

Before starting, update your system to make sure all packages are current and compatible:

sudo apt update
sudo apt upgrade -y

This reduces the risk of conflicts or broken dependencies during installation.

Step 2: Install curl (if not installed)

The installation script for V2Ray uses curl, which may not be installed by default on a minimal Ubuntu 25.04 system:

sudo apt install curl -y

This ensures you can download the installation script in the next step.

Step 3: Run the official V2Ray installation script

V2Ray provides a community-maintained installation script that sets everything up quickly.

bash <(curl -Ls https://github.com/v2fly/fhs-install-v2ray/raw/master/install-release.sh)

The script will download V2Ray, install it to the correct directories, and configure a systemd service.

Step 4: Start and enable V2Ray service

After installation, enable and start the V2Ray service so it runs in the background:

sudo systemctl enable v2ray
sudo systemctl start v2ray

You can check the service status to confirm it’s running:

sudo systemctl status v2ray

Step 5: Edit the V2Ray configuration

V2Ray uses a JSON config file located at /usr/local/etc/v2ray/config.json. Open it to make changes to the inbound and outbound rules:

sudo nano /usr/local/etc/v2ray/config.json

Modify the settings based on your use case (VMess, VLess, etc.), then save and exit.

To apply changes:

sudo systemctl restart v2ray

Optional Step: Check V2Ray logs

If V2Ray doesn’t work as expected, checking the logs can help you debug:

journalctl -u v2ray --no-pager

This shows the service output and errors in real-time.