12VPX
12VPX Neo

12VPX NEO

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

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 .deb or .rpm package, Download gets the new package for you to install.
  • OpenWrt: update the vpx package 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.

View as Markdown