12VPX NEO is our newest app, built on our own zray-core engine. It runs on computers, routers, phones and tablets, and works the same way everywhere: add your service, pick a server, connect. This page explains how the app is put together and what it can do on each device. To install it, follow the setup guide for your device.
Contents
- Guides
- Where it runs
- How it works on computers and routers
- Main screens
- What it can do on each device
- Status codes in the desktop app
- Keeping 12VPX NEO up to date
Guides
- Choosing a server
- Routing: what goes through the VPX service
- Ad blocking, Kill Switch and other settings
- 12VPX NEO on Android
- 12VPX NEO on iPhone, iPad and Apple TV
- Web interface and remote control
- 12VPX NEO on a router
- Home Node: use your home connection while away
- The vpx command line
- Support, logs and your account
Where it runs
| Device | Requirements | How you control it | Setup guide |
|---|---|---|---|
| Windows | A current version of Windows, x64 or ARM64 | Desktop app, web interface, command line | Windows |
| macOS | macOS 27 or newer on an Apple silicon Mac | Desktop app, web interface, command line | macOS |
| Linux | A current version of your distribution | Web interface, command line, optional desktop app | Linux |
| OpenWrt router | OpenWrt 25.12 or newer, x86, 64-bit ARM or 32-bit ARMv7 with a hardware FPU (no MIPS) | Web interface, command line, or the desktop app on another computer | OpenWrt |
| Android | Android 16 or newer | The app | Android |
| iPhone, iPad, Apple TV and Apple Vision | Version 26 or newer | The app | Apple devices |
On an older device, use one of our other apps, listed on the setup page for your device.
How it works on computers and routers
On Windows, macOS, Linux and OpenWrt, 12VPX NEO runs as a background service. The desktop app, the web interface and the vpx command line are three ways to control that one service. A change you make in one shows up in the others: connect from the command line and the desktop app shows you as connected.
This has two consequences worth knowing:
- Closing the app does not disconnect. Closing the window, quitting from the tray menu or closing the browser tab leaves the connection running. Press Disconnect when you want to stop.
- You can control another device. The desktop app can control a router or another computer on your network, and the web interface opens in any browser. See Web interface and remote control.
On Android, iPhone and iPad, the app controls only the device it runs on.
Main screens
On a computer:
| Screen | What it is for |
|---|---|
| Home (Dashboard in the web interface) | Connect and disconnect, see the server, routing mode, your IP addresses, traffic and how long you have been connected. |
| Servers | Search the server list, pick a server, star Favorites, or let Automatic choose. |
| Settings | Your account, appearance, network, routing, ad blocking, remote control and app version. |
| Support | Chat with support and read announcements. |
| Logs | Recent events, to copy or send when something goes wrong. |
On a phone or tablet:
| Screen | What it is for |
|---|---|
| Home | Connect and disconnect, see the location, routing mode, your IP addresses and traffic. |
| Locations | Search, sort and ping locations, and tap one to connect. |
| Support | Chat with support and read announcements. |
| Settings | Account, network, routing, ad blocking, logs and app information. On Android also Apps and Background activity. |
What it can do on each device
| Feature | Computers | Routers | Android | Apple devices |
|---|---|---|---|---|
| Automatic server choice and Favorites | Yes | Yes | No | No |
| Exclude local China routing | Yes | Yes | Yes | Yes, called Split Tunnel |
| AI routing (experimental) | Yes | Yes | No | No |
| Manual routing rules and Rocket configs | Yes | Yes | Yes | Yes |
| Ad blocking | Yes | Yes | Yes | Yes |
| DNS Leak Protection | Yes | Yes | Yes | Yes |
| Kill Switch | Yes | Yes | Use Android's own setting | No |
| Choosing which apps use it | With Proxy Only | No | Yes | No |
| Router Mode | Linux only | Yes | No | No |
| Remote control and web interface | Yes | Yes | No | No |
| Home Node | Yes | Yes | Connect to one | Connect to one |
| Command line | Yes | Yes | No | No |
| iCloud sync | No | No | No | Yes |
| Support chat | Yes | Yes | Yes | Yes |
Status codes in the desktop app
The desktop app's sidebar shows short codes for what is active right now. Hover over a code for its full meaning.
| Code | Meaning |
|---|---|
| TUN, TPX, PXO | How traffic is captured: TUN, TPROXY or Proxy Only. See Capture Mode. |
| FUL, BYP, AIM, RKT | The routing mode in use: Full tunnel, Exclude local China, AI routing or Rocket config. |
| RTR | Router Mode is forwarding traffic for other devices. |
| CTL | Remote control of this device is turned on. |
| DNS | DNS Leak Protection is active. |
| KIL | The Kill Switch is active, or is blocking traffic right now. |
| ADB | Ad blocking is on. |
| MAN | You have manual routing rules. |
Keeping 12VPX NEO up to date
- Windows and macOS: the app checks for updates once a day. To check now, open Settings → About → Software updates and choose Check for updates. Install and restart installs the update; the connection drops for a moment while it does.
- Linux: the background service checks once a day. Install its update from Settings → About in the web interface, or run
vpx update. The desktop app updates separately: an AppImage updates itself, and for a.debor.rpmpackage, Download gets the new package for you to install. - OpenWrt: update the
vpxpackage in System → Software. Versions 26.10.43 and 26.10.44 need one extra step. - Android: open Settings → About 12VPX NEO → Software update.
- iPhone, iPad and Apple TV: TestFlight installs new versions for you.
Each computer and Android version lets you pick an Update channel: Stable, recommended for everyday use, or Beta, with new features that may be less reliable.