Miscellaneous Settings

Setting up ad hoc VPN connections from different devices

Written By Marissa Fegan (Super Administrator)

Updated at February 14th, 2023

If you wish to connect to a WLVPN server from other devices, such as a router, games console or Linux device, you can configure a connection using OpenVPN. This will also work for manual connections from a PC or mobile device that supports OpenVPN.

An example OpenVPN config file is shown below. You will need to edit it for connection to a specific server and repeat this process to create multiple config files (with the extension .ovpn) for all the servers you might want to connect to. Then copy the files into your OpenVPN config folder together with the OpenVPN root certificate. Please contact support@wlvpn.com to request the root certificate.

client
dev tun
proto udp

# replace <server URL> in the line below with the
# URL of the server you want to connect to
remote <server URL> 443

resolv-retry infinite
nobind
persist-key
persist-tun
persist-remote-ip
ca vpn_api_ca_app.crt

# replace <server URL> in the line below with the
# URL of the server you want to connect to
verify-x509-name <server URL> name

auth-user-pass
comp-lzo
verb 3
auth SHA256
cipher AES-256-CBC
keysize 256
tls-cipher TLS-DHE-RSA-WITH-AES-256-CBC-SHA:TLS-DHE-DSS-WITH-AES-256-CBC-SHA:TLS-RSA-WITH-AES-256-CBC-SHA

To get a list of server URLs you can query the Reseller (v2) API. Here is an example:

curl -u api-key:<reseller API key> https://api.wlvpn.com/v2/servers

This will return all servers that are currently active and available to your users.

Note that servers are added and removed over time so we'd recommend you write some simple code to enumerate the servers from the API and build the config files.

In the example of connecting from a Windows PC, when you connect using the config file you will see the standard OpenVPN login dialog:


The user should login with their full credentials: username@auth-suffix and their password.

To avoid a password prompt, it may be possible (depending on the OpenVPN client used) to save the user credentials in a separate file. For example, some implementations allow you to add this line to your openvpn clients config file:

auth-user-pass login.conf

This will read a file named login.conf (full path may be needed) where the username and password have been listed on separate lines, like this:

username@auth-suffix
password