12VPX
12VPX
Settings

System proxy, TUN mode, kill switch and other settings in 12VPX

This page explains the settings of 12VPX and when to change them. The defaults suit most people, so you only need to change a setting for a reason. To connect and choose servers, see Signing in and connecting.

Contents

Where to find the settings

  • On a Mac, choose Preferences in the app menu, or press ⌘, while a 12VPX window is active. The window has the panes General, Accounts, Connections, Advanced, Sharing, VPN Bypass and About.
  • On Windows, choose Preferences... in the app menu, or press Ctrl+,. The window that opens is called Options, with the tabs General, Accounts, Advanced, Sharing and VPN Bypass.

Settings apply only to this computer and your user account on it.

Settings that restart the connection

Some settings only take effect when a connection starts. If you change one while connected, 12VPX asks "Changing this setting requires restarting the connection. Do you want to do that now?":

  • Yes saves the change and reconnects, so your apps lose their connection for a moment.
  • No changes nothing.

While you are not connected, 12VPX saves the change without asking and uses it the next time you connect.

At a glance

Setting Where Default Changing it while connected
System proxy Advanced On Restarts the connection
TUN for XTLS Advanced On Restarts the connection
TUN for WEB Advanced Off Restarts the connection
Kill switch for OpenVPN Advanced Off Restarts the connection
Kill switch for TUN Advanced Off Restarts the connection
Bypass XTLS or WEB VPN using rules VPN Bypass Off Restarts an XTLS or WEB connection
Share WEB or XTLS connections on my network Sharing Off Restarts the connection
Use system certificates for web traffic Advanced Off Restarts the connection
Block DNS override, Ignore HOSTS file Advanced Off Restarts the connection
Automatically connect to VPN upon launch General Off Applies the next time 12VPX starts
Launch when you log in (Windows) General Off Applies the next time you sign in to Windows
Show alert upon connection failure Advanced Off Applies right away
Global hotkeys Advanced Off Applies right away
Ping VPN servers to determine fastest server (Mac), Ping VPN servers to determine reachability (Windows) General On (Mac), Off (Windows) Applies right away

System proxy and TUN mode

How your apps' traffic reaches the VPX service depends on the connection type:

  • XTLS types, including Geo Access Only, run in TUN mode: 12VPX adds a virtual network adapter, and all apps on your computer go through the connection. This is TUN for XTLS, on by default.
  • WEB types work as a proxy: 12VPX points your computer's proxy settings at the connection, so apps that use those settings, such as most web browsers, go through it. Apps that ignore proxy settings use your normal connection, and the main window shows TUN disabled. To send all apps through a WEB connection, turn on TUN for WEB.
  • OpenVPN types always carry all traffic. These settings don't affect them.

WEB connections can't carry UDP traffic, even in TUN mode, so some voice calls, video calls and games may not work over them. Use an XTLS type for those.

System proxy lets 12VPX set your computer's proxy settings while you are connected, and puts them back afterwards. Leave it on. If you turn it off, 12VPX asks whether you are sure, and the main window then shows Warning: system proxy is not set: WEB connections, and XTLS connections without TUN mode, then carry only the apps you set up yourself.

Kill switch

The kill switch blocks your computer's internet access when your connection to the VPX service fails or your network changes, so nothing leaves over your normal connection. It is off by default, and comes as two settings under Advanced:

  • Kill switch for OpenVPN protects OpenVPN connections.
  • Kill switch for TUN protects XTLS connections, and WEB connections while TUN for WEB is on. WEB connections without TUN mode are not protected.

When the kill switch blocks your internet:

  • The status line says Disconnected and protected by VPN killswitch, and the Connect button reads Disable VPN killswitch. Clicking it gives you your internet back, without connecting.
  • 12VPX asks VPN killswitch protection active, whether to re-enable the network connection and restart the connection. Yes does both; No keeps the block.

With the kill switch on, 12VPX doesn't reconnect by itself after a failure, sleep or a Wi-Fi switch: it keeps your internet blocked until you answer. Quitting 12VPX also lifts the block. If your internet is still blocked after 12VPX closed unexpectedly, start it again and click Disable VPN killswitch.

VPN Bypass

VPN Bypass sends traffic to the websites and addresses you list past the VPX service, straight over your own internet connection. Turn on Bypass XTLS or WEB VPN using rules in the VPN Bypass pane or tab, then add your rules. The rules work on XTLS and WEB connections; OpenVPN connections ignore them.

To add a rule, type the destination in the field, check the type in the menu next to it, and click Add:

Type Matches Example
Domain Suffix The name and every name under it example.com also covers www.example.com
Exact Domain That one name www.example.com
IP One address 192.0.2.1
CIDR A range of addresses 10.0.0.0/8

To change or remove a rule, choose Modify… or Remove… from the menu on its row. The rules stay when you turn the setting off.

Good to know:

  • For a whole website, choose Domain Suffix. Type just the name, such as example.com: web addresses with https://, paths, wildcards and ports are not accepted.
  • For websites and most apps, use name rules. On XTLS connections, IP and CIDR rules only catch connections that an app makes to an address directly.
  • A rule names a destination, not an app. To leave out an app, add the names it connects to.
  • Bypassed traffic uses your own internet address, so those sites see your real location, and any limits of your network apply to them.
  • From version 1.48, on XTLS connections, the names in your name rules are also looked up with your own network's name servers. So names that only your home or office network knows keep working while you are connected.

Connection sharing

Share WEB or XTLS connections on my network, under Sharing, lets other devices on your home network, such as a game console or another computer, use this computer's connection as a proxy. It doesn't share OpenVPN connections.

  1. Turn on the setting. If your computer has more than one network, choose the one the other device uses under Share on:.
  2. Connect with a WEB or XTLS type.
  3. On the other device, set its proxy to the address and port shown after SOCKS: or HTTP:. They only show while you are connected.

The proxy has no password: anyone on the same network can use it. Only turn it on at home, never on public Wi-Fi. For step-by-step instructions, see Connection sharing.

Start-up

  • Automatically connect to VPN upon launch connects to your last server and connection type when 12VPX starts.
  • On Windows, Launch when you log in starts 12VPX when you sign in to Windows; Windows lists it as VPNGUI. Launch minified then starts it hidden in the notification area. While both are on, 12VPX starts hidden every time, not only when you sign in.
  • On a Mac, there is no setting to start 12VPX when you log in. Add 12VPX under System Settings → General → Login Items (Login Items & Extensions in newer versions of macOS) instead.

The server list

These settings are under General:

Setting What it does
Ping VPN servers to determine fastest server (Mac), Ping VPN servers to determine reachability (Windows) Measures how quickly each server answers and shows bars next to it. On by default on a Mac, off on Windows.
Order servers by ping latency (ascending) Sorts the list fastest first and shows each time, such as (35 ms). Only works while measuring is on.
Show last connected servers at top of list Puts up to five servers you chose recently at the top.
Switch server protocols globally Keeps the same connection type when you choose another server, if it offers that type.
Alert when switching connection while connected Asks before switching while you are connected. On by default.
Display application icon on Dock (Mac) Shows 12VPX in the Dock. When off, it is only in the menu bar.
Remember position of main window Opens the main window where you last left it.

Fast answers don't mean a fast connection. If your connection is slow, see Why is my connection slow?

Global hotkeys

Global hotkeys, under Advanced, turns on keyboard shortcuts that work from any app. The defaults are in Keyboard shortcuts. To change one, click Change (Mac) or Modify (Windows) next to it, press the new keys, then click Dismiss (Mac) or Close (Windows) to keep them. A shortcut needs Control, Option or Command on a Mac, or Ctrl, Alt or the Windows key on Windows, unless it is a function key. If the keys are already in use, 12VPX says the shortcut was not changed.

Networks with IPv6

Under Advanced, Show only connections compatible with local network (IPv4/IPv6) hides connection types your current network can't use, and Prefer IPv6-only if supported (OpenVPN connections only) connects OpenVPN over IPv6 when your network has it. Both are on; leave them on.

Company networks and other advanced settings

Leave these off unless you have a reason, or our support team asks:

  • Use system certificates for web traffic helps when a company network or security software inspects secure connections, so that 12VPX can't sign in or WEB connections fail. It makes 12VPX trust the certificates installed on your computer.
  • Proxies: (Mac) is for networks where you must use a proxy to reach the internet. It works for OpenVPN types only: each proxy adds entries such as OpenVPN TCP (HTTP proxy …) to the Type list.
  • Block DNS override keeps your computer's own name servers. Website names can then be looked up outside the VPX service.
  • Ignore HOSTS file makes WEB connections ignore the entries in your computer's hosts file.

Logging

The Logging: settings under General decide what goes into the log that our support team may ask for. Leave Log configuration provider interaction on and the others off. Turn on more logging only when support asks, and turn it off again afterwards. Log raw protocol transmission writes your sign-in details into the log: send that log only to us. See Send us your log.

Your own connection files (Mac)

The Mac app can also use connection files you already have, such as OpenVPN (.ovpn), Tunnelblick or Viscosity files. Double-click the file, or use + → Import connection under Preferences → Connections. Imported connections appear in the server list next to our servers. Our support team can't help with connections from your own files.

Preferences → Connections also has an Edit button for the technical properties of each connection. Only change these when our support team asks you to: a wrong value can stop a connection from working.

View as Markdown