Skip to content
This repository has been archived by the owner on Dec 31, 2021. It is now read-only.

Settings

brianhornsby edited this page May 10, 2012 · 6 revisions

Before using the OpenVPN add-on you need to configure it. Bring up the add-on settings dialog.

OpenVPN Settings

OpenVPN add-on OpenVPN settings section.

OpenVPN

Enter the location of your OpenVPN executable.

Sudo

Enable this option if your system requires sudo access to run OpenVPN.

Sudo Prompt

Enable this option if you wish to be prompted for a password everytime OpenVPN is run.

Sudo Password

Enter your sudo password here, if you don't want to be prompted for password everytime.

Important Security Note: Using this option will store your sudo password, in plain text, in the settings.xml file in the addons userdata directory on your system.

Configuration Settings

OpenVPN add-on Configuration settings section.

Root Certificate

Set this to the root certificate file you want to use with OpenVPN.

Certificate

Set this to the certificate file you want to use with OpenVPN.

Private Key

Set this to the private key file you want to use with OpenVPN

TLS Key

Set this to the TLS key file you want to use with OpenVPN.

Connections

Set this to the file you have created which contains your OpenVPN connections. The contents of the file should look like below, but change attributes to match your connections. You need to add one vpn element for each vpn connection.

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<vpns>

<vpn id="VPN1" host="tcp.vpnhost.net" port="80" proto="tcp"/>

<vpn id="VPN2" host="udp.vpnhost.net" port="1194" proto="udp" delay="20"/>

</vpns>

  • id: Set to the name you want to appear in the select dialog, e.g. 'US VPN' or 'UK VPN'. Mandatory.
  • host: The hostname for the openvpn connection. Mandatory.
  • port: The port that should be used for openvpn connection. Mandatory.
  • proto: tcp or udp. Mandatory.
  • delay: Number of seconds to wait before showing notification, after connection. Not Mandatory.

Advanced Settings

OpenVPN add-on Advanced settings section.

Default Port

The default port that will be used for OpenVPN connection, if not specified in connections.xml.

Default Proto

The default protocol that will be used for OpenVPN connection, if not specified in connections.xml.

Default Cipher

The default protocol that will be used for OpenVPN connection, if not specified in connections.xml.

Default Start Delay

The default number of seconds to wait before displaying notification when starting OpenVPN, if not specified in connections.xml.

Default Stop Delay

The number of seconds to wait before displaying notification when stopping OpenVPN.

Extra Options

Used to specify extra command line options that will be used when running OpenVPN.

Debug

Enable/Disable debugging.