---
title: V2rayA
description: 
---

V2rayA is a v2ray client for Linux and Windows which you control through your web browser.

AUTOMATIC_TABLE_OF_CONTENTS

## V2ray (xray)

#### Remove old v2ray / v2fly

To benefit from our XTLS servers, we need V2rayA to use **xray-core**, not **v2fly**.

If you previously installed **v2ray** or **v2fly**, please remove it from your system:

```
sudo rm /usr/local/bin/v2ray
sudo rm /usr/local/bin/xray
```

#### Download
Download the latest stable release of xray-core from [https://github.com/XTLS/Xray-core/releases](https://github.com/XTLS/Xray-core/releases).

Please do not download beta versions or developer previews.

#### Install
Install the binaries for xray into the /usr/local/bin directory.

On Debian/Ubuntu you would run:

```
sudo unzip Xray-linux-64.zip -d /usr/local/bin
```

Verify that the necessary files are indeed present. Run:

```
ls -l /usr/local/bin 
```

And you should see these files: (there may be others too - that's OK)

```
-rw-r--r-- 1 root root 11326721 Jan  1 01:00 geoip.dat
-rw-r--r-- 1 root root  1068329 Jan  1 01:00 geosite.dat
-rwxr-xr-x 1 root root 18837504 Jan  1 01:00 xray
```


## V2rayA

#### Download
Download the installer for v2rayA from github: [https://github.com/v2rayA/v2rayA/releases/](https://github.com/v2rayA/v2rayA/releases/).

Use version 2.2.4 or newer. Older versions are not compatible with Xray.

They offer installers for Arch Linux, Debian (works with Ubuntu, etc.), FreeBSD, RedHat and Windows. There's also a binary for macOS, but no installer.

#### Install

Install the downloaded package. On Debian/Ubuntu you would run:

```
sudo dpkg -i installer_debian_amd64_2.2.4.deb
```

(Change the version number to match what you downloaded.)

## Start and Enable

Start v2raya using the following command:

```
sudo systemctl start v2raya
```

If you want to start v2raya automatically whenever you start your computer, you may also run:

```
sudo systemctl enable v2raya
```


>At this point the web interface for v2rayA is accessible to everyone on your local network! It's important to proceed with the next steps immediately.

Note: when starting v2raya, it tries to download some GeoIP databases. If that fails, v2raya will not start.

## iptables

IPtables is required. If your computer does not have it, or if you are not sure, you can install it by running:

```
sudo apt install iptables
```

## geosite.dat

If you're in China, v2rayA may fail to download the necessary **geoip.dat** and **geosite.dat**. Fortunately, we can just use the ones bundled with xray-core instead:

```bash
sudo cp /usr/local/bin/geoip.dat /root/.local/share/xray
sudo cp /usr/local/bin/geosite.dat /root/.local/share/xray
```

Then restart v2raya:

```bash
sudo systemctl restart v2raya
```

## Using v2rayA

Now that v2rayA is running, please proceed to [using v2rayA](/en/setup/linux/using-v2raya).