---
title: 12VPX NEO for OpenWRT
description: 
---

AUTOMATIC_TABLE_OF_CONTENTS

## Requirements

* OpenWRT 25.12 or newer. 
* Older versions of OpenWRT use a different packaging format and cannot be used.
* Router with 1 WAN port **and** 1 (or more) LAN port.
* Supported router architectures: x86_64, i686, aarch64 and armv7. No mips.

## Warning

Our instructions assume a clean install of the official OpenWRT release. Other flavors of OpenWRT, or routers with a complicated setup, may not work as expected.

The GL.iNet flavor of OpenWRT does **not** work. Some GL.iNet models can be converted to the official OpenWRT. We recommend their Flint 2 router with the official version of OpenWRT.

## Repo Key

Before we can install the 12VPX software we need to add the 12VPX signature to the router.

* Navigate to **System** > **Administration** > **Repo Public Keys**.
* Copy & paste the key below to add it as a new key.

```
-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAztjKpAl1ExDc1gCKBKmy
46qpUvQcM5gYtLHYZAQH9y7eOel1aRZFpWvkNgrOEK1Q8//KCCT6O61U896xgET+
CUW0MUtiJucKL0kkzlxSebhAFHVv1VIrQGk7LD1SbEjeVS1sZZmLaefzN4WBI4XK
gynTDnlBn/6F1nwTkHqAj0dvOhg210drHPnpyk0n5GRvISVJfqTgh2FvXM0W11pe
RA9PZF7L9l7nhw3T3zY8MHMBjgY5iom0gNM6Duv0OIf/HvqmPaLkLyMFsAk7u9Su
f7nELUku4vWrKiqmybNlxIoGYBLh9p8fQDXugy/xVnrEt/BvaX71XXJwmTGPjAPr
uVKIuknZ4JSv5gBuj8OYIxuiT+bPjlbUESRazJoxmxDCw+MkjjIb1NZG0kgvHE+8
zr22pW2OjCdLN0iy1H7S/EHeTAjPkgCwskgy8FKy4ziqpB0NdgtRrtjcAtR02CYA
DGkKBPWMpt+CLmPRQiPFkYNhxnV1kd+6GtDAGAUXoBf+296+bF6HhwEVSKdxuQFk
3e/Z/oklmNrgugZYq2DlevIvUokzXDK9/pghu58lgPvjWaINQU23WIHSnEGqUWa1
rLpZtgYPU9UuCvP7e3+446lpZm51WMjDxujoUg5sCgl2Ra+z76zCM5SUO8BquY8I
XLWWIZtgloXctZ8n9YPWwvECAwEAAQ==
-----END PUBLIC KEY-----
```

![](https://media.vpx.moe/448/Screenshot-2026-06-07-at-13.51.46.png)

The result will look something like this:

![](https://media.vpx.moe/451/Screenshot-2026-06-07-at-13.52.00.png)

You may delete the 12VPX repo key when you don't need it anymore. Just be very careful not to delete the openwrt repo key.

## Repo Setup

Next we'll add the 12VPX repository to your router.

* Navigate to **System** > **Software**.
* Click **Configure APK**.

![](https://media.vpx.moe/454/Screenshot-2026-06-07-at-14.06.42.png)

* Add our URL to the customfeeds.list section:
  *  **Stable** version: ```https://dl.wanwire.com/openwrt/APKINDEX.adb```
  *  **Beta** version: ```https://dl.wanwire.com/openwrt/beta/APKINDEX.adb```
* Click Save.

![](https://media.vpx.moe/457/Screenshot-2026-06-07-at-14.09.36.png)

* Update the software list by clicking **Update lists...**

![](https://media.vpx.moe/460/Screenshot-2026-06-07-at-14.10.52.png)

* Check the result for error messages.

![](https://media.vpx.moe/463/Screenshot-2026-06-07-at-14.12.43.png)

## Install 12VPX

We'll now install the 12VPX app.

* Search the repo for **vpx**, then click **Install**.

![](https://media.vpx.moe/466/Screenshot-2026-06-07-at-14.15.05.png)

* Click Install to proceed.

![](https://media.vpx.moe/469/Screenshot-2026-06-07-at-14.15.17.png)

Check the result for errors:

![](https://media.vpx.moe/472/Screenshot-2026-06-07-at-14.30.14.png)

## Configure 12VPX

If all went well, you can now access the 12VPX app by opening [http://192.168.1.1:9847/](http://192.168.1.1:9847/).

Navigate to **Settings**, copy and paste the **Subscription URL** and click **Update**.

![](https://media.vpx.moe/475/Screenshot-2026-06-07-at-14.35.57.png)


### Subscription URL

![](https://media.vpx.moe/478/Screenshot-2026-06-07-at-14.36.54.png)

## Connecting to a 12VPX server

Navigate to the Servers tab, find your preferred server, and click Connect.

![](https://media.vpx.moe/481/Screenshot-2026-06-07-at-14.39.10.png)

## China

If you're in China, we recommend you go into **Settings** > **Routing** and switch the routing mode to **Exclude Local China**.

## Troubleshooting

### Update failures

Some versions, notably v26.10.43 and v26.10.44, refuse to be updated. If you run into this, please:
* Uninstall the old version (your settings will be retained)
* Reboot the router
* Install the latest version