Download & Install


V2Ray is available on the following platforms:

  • Windows 7 and later (x86 / amd64)
  • Mac OS X 10.10 Yosemite and later (amd64)
  • Linux 2.6.23 and later (x86 / amd64 / arm / arm64 / mips64 / mips)
    • Including but not limited to Debian 7 / 8, Ubuntu 12.04 / 14.04 and later, CentOS 6 / 7, Arch Linux
  • FreeBSD (x86 / amd64)
  • OpenBSD (x86 / amd64)
  • Dragonfly BSD (amd64)


Pre-built packages can be found here:

  1. Github Release:
  2. Redistribution:
  3. Homebrew:
  4. Arch Linux: packages/community/x86_64/v2ray/
  5. Snapcraft:

All packages are in ZIP format. Download and unzip corresponding packages to your system.


There are 2 ways to verify packages.

  1. Each .zip file has a corresponding .dgst file for SHA digests.
  2. The GPG signature file for executables (v2ray / v2ray.exe) can be found in v2ray.sig (or v2ray.exe.sig) in the same package. Public key is in the repository.

Install on Windows or Mac OS

Run v2ray / v2ray.exe after unzip the packages.

Install on Linux

We provide a script to install on Linux. This script detects previous installed v2ray and then upgrade or install a new one accordingly. If there is a previous version, the config file in /etc/v2ray will not be overwritten during upgrade.

The following command assumes root permission.

Run the following command to install V2Ray. If yum or apt is available, the script will install unzip and daemon / systemd. They are required to run V2Ray as a service. You need to install them manually if your Linux system doesn't support yum or apt.

curl -Ls | sudo bash

The script installs the following files.

  • /usr/bin/v2ray/v2ray: V2Ray executable
  • /usr/bin/v2ray/v2ctl: Utility
  • /etc/v2ray/config.json: Config file
  • /usr/bin/v2ray/geoip.dat: IP data file
  • /usr/bin/v2ray/geosite.dat: domain data file

This script also configures V2Ray to run as service, if systemd is available.

Configurations are at the following places.

  • /etc/systemd/system/v2ray.service: Systemd
  • /etc/init.d/v2ray: SysV

After installation, we will need to:

  1. Update /etc/v2ray/config.json file for your own scenario.
  2. Run service v2ray start command to start V2Ray.
  3. Optionally run service v2ray start|stop|status|reload|restart|force-reload to control V2Ray service. supports the following parameters.

  • -p or --proxy: Use a proxy to download V2Ray packages. Same as curl format, such as "socks5://" or "".
  • -f or --force: Force installation. The script will assume V2Ray was not installed at all.
  • --version: The version to be installed, such as "v1.13". Default value is the latest stable release.
  • --local: Use a local package for installation.


  • Use SOCKS proxy to install the latest package: ./ -p socks5://
  • Install v1.13 from local file:./ --version v1.13 --local /path/to/


V2Ray provides 2 docker images:

The 2 images has the same structure as the Linux installation.