--- title: 12VPX for macOS and Windows description: What the 12VPX app for Mac and Windows is, how it differs from 12VPX NEO, how it works from the menu bar or the system tray, your account in the app, and all the guides for using it. --- 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](/en/setup/macos/12vpx-macos) or [Windows](/en/setup/windows/12vpx-windows). AUTOMATIC_TABLE_OF_CONTENTS ## Guides - [Signing in and connecting](/en/docs/12vpx/connecting) - [System proxy, TUN mode, kill switch and other settings](/en/docs/12vpx/settings) - [Support and troubleshooting](/en/docs/12vpx/troubleshooting) ### More about 12VPX - [Connection types](/en/docs/12vpx-connection-types) - [Route lists](/en/docs/route-lists) - [Connection sharing](/en/docs/connection-sharing) - [Error 2503](/en/docs/windows-error-2503) ### Using other apps with 12VPX - [Dropbox](/en/docs/dropbox-12vpx) - [Git and GitHub](/en/docs/git-12vpx-web) - [LINE](/en/docs/12vpx-line) - [Signal](/en/docs/signal-12vpx) - [Telegram](/en/docs/telegram-12vpx) - [Terminal and Command Prompt](/en/docs/12vpx-command-line-proxy) - [Thunderbird](/en/docs/12vpx-thunderbird) - [WhatsApp](/en/docs/whatsapp-desktop) - [WSL2](/en/docs/12vpx-wsl2) ## 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](/en/docs/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](/en/setup/macos/12vpx-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](/en/setup/windows/12vpx-windows) | There is no 12VPX app for phones and tablets. For those, see the [setup guide](/en/setup) for your device. ## How 12VPX works - You sign in with the **VPX username** and **VPX password** from our [Credentials page](/en/credentials). 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](/en/servers). - 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](/en/devices). ## 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](#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](/en/docs/12vpx/settings). | | **Help** (Mac), **Help...** (Windows) | Version 1.48 and newer: explains the codes at the end of the app's messages. See [Message codes](/en/docs/12vpx/troubleshooting#message-codes). | | **View log** | Opens the **Log viewer**. See [Send us your log](/en/docs/12vpx/troubleshooting#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](/en/docs/12vpx/connecting#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](/en/docs/12vpx/connecting#choose-a-server). | | Connection type | **Type** on a Mac, a button with the type's name on Windows. See [Choose a connection type](/en/docs/12vpx/connecting#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](/en/docs/12vpx/connecting#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](/en/docs/12vpx/settings#system-proxy-and-tun-mode). | | **Warning: system proxy is not set** | The **System proxy** setting is off. See [System proxy and TUN mode](/en/docs/12vpx/settings#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](/en/setup/macos/12vpx-macos) or [Windows](/en/setup/windows/12vpx-windows). If an update fails on Windows, see [Resolving a failed 12VPX upgrade](/en/12vpx-for-windows-update-failure).