This page explains how to sign in to 12VPX, choose a server and a connection type, and connect. It also explains what the app tells you while it works, and what its messages about your account mean.
Contents
- Sign in
- Choose a server
- Choose a connection type
- Connect and disconnect
- Switch server or connection type
- What the status line says
- Keep your server list up to date
- When 12VPX connects by itself
- Keyboard shortcuts
- Messages about your account
Sign in
- Open the main window: click the 12VPX icon in the menu bar (Mac) or in the notification area of the taskbar (Windows).
- Enter your VPX username and VPX password from our Credentials page. These are not your e-mail address and website password.
- Click Login.
The status line shows Connecting to API server while the app signs in, and then your servers appear. If sign-in fails, see Can't sign in.
Good to know:
- 12VPX removes spaces as you type, in both fields.
- The first time you start it, 12VPX installs its helper, the part that changes your network settings while you are connected. On a Mac, macOS asks for an administrator's password; on Windows, Windows may ask for permission. Approve it: 12VPX can't connect without the helper.
- On hotel, airport or café Wi-Fi, first complete the network's sign-in page in your browser. Until then, 12VPX can't reach our website or our servers.
Choose a server
The server list shows the servers on your account. You add, hide and reorder them on our Servers page; choose Update configuration in the app menu afterwards to see the change in the app.
Next to each server:
- Bars show how quickly the server answered the last time 12VPX measured it, compared with your other servers. More bars means a faster answer. Dashes mean it hasn't been measured yet or didn't answer.
- The color shows the server's status: green is available, amber is partly available, red is unavailable, and gray is unknown. You can't choose an unavailable server.
- On Windows, servers show only a colored dot unless you turn on Ping VPN servers to determine reachability in the settings. On a Mac, measuring is on by default.
The bars measure how quickly a server answers from your computer. They are not a speed test. If your connection is slow, see Why is my connection slow?
To sort the list fastest first, or to keep your recent servers at the top, see The server list.
Choose a connection type
Each server offers one or more connection types. Choose one in the Type list on a Mac, or with the button next to Connect on Windows, which shows the name of the current type.
You will see names such as XTLS, WEB, Geo Access Only, OpenVPN and OpenVPN TCP. What each one does is explained in 12VPX connection types. Which ones you see depends on your account's settings on our website:
- XTLS and WEB also come in a version with a country in the name, such as XTLS China. Its country is the one you chose under Location-Based Optimization on our Servers page.
- WEB and its version with a country appear only while WEB Protocol is on in your account's Advanced settings.
- Geo Access Only appears when you have turned on services on our Geo Access page.
- Each of your route lists adds a WEB type with the name of the list.
XTLS needs macOS 12 or Windows 10 or newer. On older systems, XTLS types are listed but grayed out, with (requires Windows 10 or newer) on Windows, or a note that it requires macOS 12 Monterey on a Mac.
12VPX also hides types that can't work on your current network, for example types that need IPv6 on a network without it. You can change this with Show only connections compatible with local network (IPv4/IPv6), but leave it on.
Connect and disconnect
- Choose a server.
- Choose a connection type.
- Click Connect.
The status line says Connecting to and then Connected to, each followed by your server and connection type. The icon in the menu bar or the taskbar changes.
To stop, click Disconnect. To stop while it is still connecting, click Cancel connecting.
After connecting, 12VPX checks that the connection really carries traffic. If it doesn't, the app shows VPN connection problem. Choose another server or connection type.
Switch server or connection type
You don't need to disconnect first: choose another server or type while connected.
- 12VPX first asks Already connected, whether to disconnect and connect to the new choice. Click Yes. To stop this question, tick its checkbox; Alert when switching connection while connected in the settings brings it back.
- No selectable connections means the server you chose has no type that can be used right now. Disconnect first, or choose another server.
- Server not available means the server is unavailable at the moment. Choose another one.
With Switch server protocols globally on, 12VPX keeps the same connection type when you choose another server, if that server offers it.
What the status line says
| Status | What it means |
|---|---|
| Connecting to API server | 12VPX is signing in to our website. If it stays, see Can't sign in. |
| Updating server list | 12VPX is downloading your list of servers. |
| Server list update failed, with Next try at and a time | The last update of your list didn't work. 12VPX keeps the list it has and tries again at that time. See The server list won't update. |
| Connecting to, Connected to | Followed by your server and connection type. |
| Suspending, Suspended | Your network went away or changed, for example when your computer went to sleep or you switched Wi-Fi. 12VPX connects again by itself when the network is back. |
| Connection failed | The last attempt to connect didn't work. Try again, then another connection type or server. |
| Disconnected and protected by VPN killswitch | The kill switch blocks your internet. See Kill switch. |
| Account suspended, with Next check at and a time | See Account suspended. |
| Waiting for the VPN helper | See The helper. On Windows it says Waiting for the VPN helper service. |
From version 1.48, some of these end with a code, such as (V23A39). See Message codes.
Keep your server list up to date
12VPX downloads your list of servers right after you sign in and updates it by itself from then on. Configuration: in the main window shows when the last update worked:
| Age of the list | What you see |
|---|---|
| Up to 24 hours | Everything is normal. |
| More than 24 hours | The date turns red and a warning icon appears next to the connection types. You can still connect. |
| More than 72 hours | An error icon appears and Connect is grayed out until an update works. |
To update right away, choose Update configuration in the app menu. Do this after you change something on our website, such as your servers, Location-Based Optimization, WEB Protocol or Geo Access: 12VPX sees the change with its next update.
If the update fails, see The server list won't update.
When 12VPX connects by itself
- After a network change or sleep, 12VPX connects again by itself as soon as the network is back. Click Disconnect if you don't want that.
- If a connection fails while you use it, 12VPX restarts it. To be told each time, turn on Show alert upon connection failure; the app then shows Connection failure.
- With the kill switch on, 12VPX doesn't reconnect by itself. It keeps your internet blocked and asks what to do. See Kill switch.
- When the app starts, it connects to your last server and connection type if Automatically connect to VPN upon launch is on. See Start-up.
Keyboard shortcuts
With Global hotkeys turned on in the settings, these shortcuts work from any app:
| Action | Mac | Windows |
|---|---|---|
| Connect or disconnect | Control-Option-V | Ctrl+Alt+V |
| Connect | Control-Option-C | Ctrl+Alt+C |
| Disconnect | Control-Option-D | Ctrl+Alt+D |
To change one, see Global hotkeys. While the kill switch blocks your internet, the shortcuts for Connect and for connecting or disconnecting only lift the block; they don't connect.
Messages about your account
Device limit reached
Device limit reached means your account already has as many devices as it allows, so this computer can't be added. The message says: "Your account already has the maximum number of registered devices. Use the Devices page on our website to remove a device you no longer use, then try again."
Sign in to our website, open the Devices page, delete devices you no longer use, then sign in again. Devices that are already set up keep working. A VPX account is for one person: other people need their own VPX account.
Account suspended
When your service is suspended, version 1.48 and newer show Account suspended with the reason. 12VPX stays signed in with your servers and settings, so you don't need to sign in again afterwards. While you are not connected, the status line says Account suspended and when the app checks again, after Next check at.
| Reason in the app | What to do |
|---|---|
| An invoice is overdue | Pay it on our invoices page. |
| BitTorrent was used | Restore your service yourself on the unsuspend page. Suspended for BitTorrent use explains the causes. |
| Terms of service, device limit, or no reason given | Contact support. |
Once your service is restored, 12VPX works again at its next check. To check right away, choose Update configuration in the app menu.
Version 1.47 and older show Login failed: with the reason instead, and sign you out. After your service is restored, sign in again.
Login failed
Login failed: followed by a reason means our website didn't accept the sign-in, and 12VPX signs this computer out. See Can't sign in.