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
2. Arch Linux: packages/community/x86_64/v2ray/

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 package manager: scoop install v2ray
• Install via Chocolatey 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 package manager: brew install v2rayw
  • You can continue using v2ray/v2ray Tap, 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.

Installing on Linux by Script

The original installation script is deprecated and replaced by fhs-install-v2ray.

Go to #2328 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
• Insufficient permissions when using certificates
• Migrate from the old installation script
• Move .dat files from lib to share directory
• Use the VLESS Protocol

Docker

The V2Ray Docker Image is also available:

• v2fly/v2fly-core: The latest tag will be updated following v2fly'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