These instructions apply to our regular 12VPX app. They do not apply to our 12VPX NEO app.

When you use our 12VPX app in WEB mode (as opposed to OpenVPN mode) most command-line utilities will not use the VPN automatically.

Proxy

Fortunately, when using 12VPX in WEB mode, it runs a local proxy server that many command-line utilities can use. This proxy runs a 127.0.0.1:16005.

When using the TLS, gRPC or XTLS modes, use 127.0.0.1:16006 instead.

In OpenVPN mode there is no proxy.

Apps

Some command-line apps have their own way to configuring the proxy settings. See our git instructions for example.

Environment variables

Many command-line apps will check the environment variable to see if a proxy should be used. Below commands set the relevant variables for use with 12VPX.

macOS

export HTTP_PROXY="http://127.0.0.1:16005"
export https_proxy="http://127.0.0.1:16005"

You'll notice that we uppercase HTTP_PROXY but lower-cased https_proxy. This combo works well in our experience, but you may want to use upper- and lower-case version of both if you're unsure what exactly your command-line apps need.

Windows

set HTTP_PROXY=http://127.0.0.1:16005
set HTTPS_PROXY=http://127.0.0.1:16005

Windows Persistent

If you want your Windows proxy settings to survive reboots, you can the follow:

USE WITH CARE - APPS MAY STOP WORKING WHEN THE VPN IS DISCONNECTED

setx HTTP_PROXY=http://127.0.0.1:16005 /M
setx HTTPS_PROXY=http://127.0.0.1:16005 /M