Installation

Supported OS Platforms

The following platforms are supported by V2Ray:

• Windows 7 and later（x86 / amd64 / arm32）
• macOS 10.10 Yosemite and later（amd64）
• Linux 2.6.23 and later（x86 / amd64 / arm / arm64 / mips64 / mips / ppc64 / s390x / riscv64）
  • including but not limited to Debian 7 / 8, Ubuntu 12.04 / 14.04 and later, CentOS 6 / 7 and Arch Linux
• FreeBSD (x86 / amd64)
• OpenBSD (x86 / amd64)
• Dragonfly BSD (amd64)

Download V2Ray

Compiled binary packages can be found via the following links.

1. Github Release: github.com/v2fly/v2ray-core (opens new window)
2. Arch Linux: packages/community/x86_64/v2ray/ (opens new window)

All packages are in the .zip format. Look for the file matching your platform and unzip it to get started.

Package Integrity

The integrity of V2Ray can be validated in two ways:

1. The SHA1 / SHA256 digest information can be found in the corresponding .dgst files.
2. Run v2ctl verify --sig=Release example-file

Windows Installation

• Download and unpack the zip file, you will get an executable v2ray.exe.
• Install via Scoop (opens new window) package manager: scoop install v2ray
• Install via Chocolatey (opens new window) package manager: choco install v2ray

Then run V2Ray in command line.

macOS Installation

• Download and unpack the zip file, you will get an executable v2ray.
• Install via Homebrew (opens new window) package manager: brew install v2rayw
  • You can continue using v2ray/v2ray Tap (opens new window), however this is not recommended.

Then run V2Ray in command line.

Linux Distro Repository

Some distros may have included V2Ray to their repositories. It is recommended to use these repositories for better compatibility before using any installation script.

• Debian: golang-v2ray-core (opens new window).

Installing on Linux by Script

The original installation script is deprecated and replaced by fhs-install-v2ray (opens new window).

Go to #2328 (opens new window) for related discussions.

What's new?

• Changed Installation Path V2Ray to comply with FHS.
• Stopped supporting stone age platforms, such as CentOS 6.
• Stopped supporting System V.
• Changed the service user from root to nobody.

FAQ (In Chinese)

• Install without updating geoip.dat and geosite.dat (opens new window)
• Insufficient permissions when using certificates (opens new window)
• Migrate from the old installation script (opens new window)
• Move .dat files from lib to share directory (opens new window)
• Use the VLESS Protocol (opens new window)

Docker

The V2Ray Docker Image is also available:

• v2fly/v2ray-core (opens new window): The latest tag will be updated following v2fly (opens new window)'s latest release. Other versions will be released using the version's tag, e.g. 4.27.0.

The Structure of Docker Image:

• /etc/v2ray/config.json: Config File
• /usr/bin/v2ray/v2ray: V2Ray Main Process
• /usr/bin/v2ray/v2ctl: V2Ctl Commandline Tools
• /usr/bin/v2ray/geoip.dat: GeoIP Data
• /usr/bin/v2ray/geosite.dat: GeoSite Data