Desktop and mobile clients

V2Ray Client Downloads

Choose your operating system, then select a package by CPU architecture and format. Use v2rayN on desktop and v2rayNG on Android.

  1. Choose your platformCheck the operating system you’re using
  2. Check the architectureChoose x64 or arm64
  3. Download the packageImport your subscription after downloading

Choose a package by platform

Downloading for another device? Use that device’s system information.

Windows packages

CheckRequirements and options
System and architectureFor Windows 10/11 x64. Go to Settings → System → About and check that System type lists an x64-based processor.
FormatExtract the entire ZIP archive before running the installer from the extracted folder.
Runtime requirementsIf the installer reports a missing runtime component, check the required version and architecture in the prompt.

If your computer is managed by your organization, check with your administrator before installing. A standard installation and enabling TUN later are separate tasks; you don’t need elevated privileges just to download the client or import a subscription.

Before you install: checks and config migration

Check your system, architecture, and distribution

A single client may have several packages, but that doesn’t mean they’re interchangeable. Your operating system determines which installer format to use; the architecture determines whether the app can run on your device; and your distribution and its dependencies determine whether the package manager can install it. For example, system settings may describe both x64 and arm64 as “64-bit,” but that alone isn’t enough to choose a package. On Linux, amd64 and x86_64 in a filename refer to the same architecture class, not a specific processor brand.

When installing in a virtual machine, check the system and architecture shown inside the VM, not the host machine. The same applies when moving to a new computer: a package that worked on the old machine may not work on the new one, but you can usually import your subscription URL into the new client. If the installer reports an OS version or dependency mismatch, downloading the same package again won’t change your system. Save the exact error message, then decide whether to upgrade the OS or choose a compatible package.

Back up recoverable config before upgrading

Note your subscription group names, active server, and routing mode in the current client. Record any custom DNS settings or local listening ports too. If the client can export its config, save the file outside the app’s directory so it won’t be deleted along with app data if you uninstall. Subscription URLs may contain access credentials, so store backups securely and never post a full URL in a public forum or screenshot when asking for help.

Adding your subscription again usually restores the list provided by the service, but it may not restore manually added servers, your previously selected routing mode, or local overrides. Back these up separately: keep the subscription source, and save an export or notes for manual settings. When switching clients, import a compatible subscription first, then set up client-specific options again. Don’t copy the entire app data directory into another app.

Confirm installation before changing network settings

After launching the client for the first time, make sure the main window opens and check that the server list and subscription groups look right. An empty list after a fresh install is normal. If an existing setup appears empty, clear any list filters and check the selected group and client. Installation doesn’t update your subscription or enable the system proxy. Handle each step separately to pinpoint where something went wrong.

When switching desktop clients, close the old window and make sure its background process has exited from the system tray. Two clients running at once may compete for the same port or change system proxy settings in turn. On a phone, Android may show a VPN connection request the first time you connect; check the app name in the prompt. Disconnect from the old client before testing the new one. Adjust routing, DNS, or TUN only after the basic connection works.

See the guide to importing subscriptions and connecting →

Download and installation FAQs

First identify whether the issue is with package selection, installation, or configuration, then follow the relevant steps.

Do I need to install both the Windows Desktop and classic WPF editions?

No. Choose Desktop for a first-time installation, or stick with the classic edition if you prefer WPF. Save your config before switching, and close the old client before testing to prevent both apps from competing for local ports or changing system proxy settings.

What’s the difference between the Android universal and arm64 packages?

The arm64 package is for systems that support arm64-v8a. The universal package includes multiple architectures supported by the app build and is usually larger. If you’re unsure of your device’s architecture, start with the universal package. It won’t fix an outdated Android version or a signature conflict.

What if the version number on the download page doesn’t match the filename?

The version shown on the card comes from the release manifest and may not be updated at the same time as the package name. Check the app, platform, and architecture first. If the downloaded package isn’t the version you expected, don’t overwrite your existing installation; wait for the manifest to be updated and check again.

Will updating the client keep my existing subscriptions?

A standard in-place update of the same app will usually keep its data, but don’t count on that after uninstalling and reinstalling, switching clients, or changing the config directory. Back up any exportable config before updating, note your subscription groups and routing settings separately, and check the list before connecting.

Where do I import a subscription after installation?

In v2rayN, add and update subscriptions under Subscription Groups. In v2rayNG, open Subscription Group Settings from the sidebar, then return to the list to update. Downloading a client doesn’t provide a subscription; get the subscription URL from your service provider or administrator.