--- title: System proxy, TUN mode, kill switch and other settings in 12VPX description: What the 12VPX settings for the system proxy, TUN mode, the kill switch, VPN Bypass, connection sharing, start-up, the server list and company networks do on Mac and Windows, their defaults, and which ones restart your connection. --- 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](/en/docs/12vpx/connecting). AUTOMATIC_TABLE_OF_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](/en/docs/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?](/en/docs/slow-connection) ## Global hotkeys **Global hotkeys**, under **Advanced**, turns on keyboard shortcuts that work from any app. The defaults are in [Keyboard shortcuts](/en/docs/12vpx/connecting#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](/en/docs/12vpx/troubleshooting#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.