12VPX is our established app for Mac and Windows computers. You sign in with your VPX username and password, choose a server and a connection type, and connect. This page explains how the app is organized and where to find each guide. To install it, follow the setup guide for macOS or Windows.
Contents
- Guides
- 12VPX or 12VPX NEO?
- Where it runs
- How 12VPX works
- In the menu bar or the system tray
- The app menu
- The main window
- Your account in the app
- Why it says VPNGUI in places
- Updates
Guides
- Signing in and connecting
- System proxy, TUN mode, kill switch and other settings
- Support and troubleshooting
More about 12VPX
Using other apps with 12VPX
12VPX or 12VPX NEO?
Both apps connect you to the same VPX service. Choose one per computer:
- 12VPX is our established app and the quickest way to get connected, built for ease of use, stability and speed. Choose it if you want a simple, familiar app that just connects, or if your computer runs an older version of macOS or Windows.
- 12VPX NEO is our newest app, for macOS 27 and up on Apple silicon Macs and for the latest version of Windows. It keeps itself up to date. Choose it if you want more control, like a web interface, themes or optional AI routing.
You can use 12VPX on one computer and 12VPX NEO on another.
Where it runs
| Computer | Good to know | Setup guide |
|---|---|---|
| Mac | Also runs on older versions of macOS. XTLS connections need macOS 12 or newer. | macOS |
| Windows PC | Also runs on older versions of Windows. XTLS connections, TUN mode and the kill switch for TUN need Windows 10 or newer. | Windows |
There is no 12VPX app for phones and tablets. For those, see the setup guide for your device.
How 12VPX works
- You sign in with the VPX username and VPX password from our Credentials page. They are not your e-mail address and website password.
- After you sign in, 12VPX downloads your list of servers and their connection types from our website and keeps it up to date by itself. The servers are the ones on your account's Servers page.
- Everything 12VPX does affects only the computer it runs on. While you are connected it changes that computer's network settings, and it puts them back when you disconnect. Settings are not shared between computers.
- Each computer you sign in on counts as a device on your Devices page.
In the menu bar or the system tray
- On a Mac, 12VPX lives in the menu bar at the top right of the screen. Click its icon to open the main window; right-click or Control-click it for the app menu. The icon turns blue while you are connected. The app also shows in the Dock, unless you turn that off in the settings.
- On Windows, 12VPX lives in the notification area at the right of the taskbar, sometimes behind the arrow that shows hidden icons. Click its icon to open the main window; right-click it for the app menu.
Closing the main window doesn't disconnect you and doesn't quit the app. To disconnect, click Disconnect. To close 12VPX, choose Quit in the app menu; quitting also disconnects.
The app menu
The same menu opens from the icon and from the button with three lines in the main window.
| Item | What it does |
|---|---|
| Accounts (Mac) | Shows your account, with Log out. See Your account in the app. |
| Log out (Windows) | Signs this computer out of your account. |
| Preferences (Mac), Preferences... (Windows) | Opens the settings. On Windows the window is called Options. See Settings. |
| Help (Mac), Help... (Windows) | Version 1.48 and newer: explains the codes at the end of the app's messages. See Message codes. |
| View log | Opens the Log viewer. See Send us your log. |
| Ping servers (Mac) | Measures now how quickly each server answers. |
| Update configuration | Downloads your list of servers now. See Keep your server list up to date. |
| Update this app | Checks for a new version of 12VPX. |
| Quit | Disconnects and closes 12VPX. |
While a 12VPX window is active, ⌘, (Ctrl+, on Windows) opens the settings, ⌘L (Ctrl+L) the log and ⌘U (Ctrl+U) updates your list of servers.
The main window
The title of the main window shows 12VPX and the version number. Below the artwork:
| Part | What it shows |
|---|---|
| Server list | Your servers. Bars or a colored dot next to each name show how it answers. See Choose a server. |
| Connection type | Type on a Mac, a button with the type's name on Windows. See Choose a connection type. |
| Connect | Connects. While connecting or connected it reads Cancel connecting or Disconnect. |
| Status line | What the app is doing, such as Connected to your server and connection type. See What the status line says. |
| Duration:, Bytes received:, Bytes sent: | How long you have been connected and how much data went through the connection. |
| IP Address: | The address that websites see while you are connected. It can stay empty although the connection works. |
| Configuration: | When your list of servers was last updated. It turns red when it is more than 24 hours old. |
| TUN disabled | Only apps that use your computer's proxy settings go through this connection. See System proxy and TUN mode. |
| Warning: system proxy is not set | The System proxy setting is off. See System proxy and TUN mode. |
Your account in the app
- On Windows, 12VPX holds one account at a time. Preferences... → Accounts shows it after Account:, with Expires:, the date your current service period ends. To use another VPX account, choose Log out and sign in with the other username and password.
- On a Mac, the Accounts menu shows your account as Log out: followed by your username. Preferences → Accounts shows it with the date your current service period ends. The Mac app can also hold more accounts with Add account..., which asks for an API URL as well as a username and password. You only need it if our support team gives you one.
Log out disconnects, signs this computer out of your account and removes the downloaded list of servers. The computer then no longer counts as a device on your account. Your settings stay. Renewing your service on our website keeps 12VPX working; you don't need to sign in again.
Why it says "VPNGUI" in places
12VPX is built on software called VPNGUI, and some places in the app still show that name. For example the About pane on a Mac, questions such as Reset VPNGUI?, the app menu at the top left of a Mac's screen (About vpngui, Quit vpngui), and on Windows the start-up entry and the background service VPNGUIHelper. They are all part of 12VPX.
Updates
To check for a new version, choose Update this app in the app menu, and install the update it offers. Keep 12VPX up to date: our support team helps with the current version. If the app says Application not supported, your version is too old to sign in: update it, or download it again from the setup guide for macOS or Windows. If an update fails on Windows, see Resolving a failed 12VPX upgrade.