Developer Cloud Sandboxes solution

h1. VPN Setup

{{>toc}}

h2. Introduction

The purpose of this section is to lead the users to install and use their OpenVPN Client, in order to establish connection with Terradue's VPN server.

Since June 2013, a new way to establish your virtual private network is in place. 

We expect it to be more easy and intuitive.

*IMPORTANT NOTICE*: if you have a previously installed VPN client (e.g. tunnelblick) on your system, such *previously installed client must be disconnected* and then be disabled (we recommend uninstalling it).

h2. Automated setup

For the initial setup, you can now directly go to: 

https://cloud.terradue.com:1194/?src=connect

It opens a prompt page in your browser, for downloading your own pre-configured OpenVPN Client.

_Here, all the configuration is automated for you, you'll only have to approve the access by the new client._

To proceed, follow these steps:

* Provide in the prompt page your username & password, it will refresh the page with a message and link "Please click here to continue to download OpenVPN Connect."

* Click on the link provided in order to start downloading your installer, it should take only a few seconds

* Run the downloaded "openvpn-connect" installer on your machine, so to install your pre-configured OpenVPN Client 

* Now launch your OpenVPN Client, you will see it running in your desktop tray ("OpenVPN Connect" icon)

h2. Running your VPN connection

* In your desktop tray, click on the "OpenVPN connect" icon

* From the dropdown menu, select the entry "Connect to Cloud.terradue.com"

* Provide your username and password to approve the access

You are now connected !

Check that the "OpenVPN Connect" icon in your desktop tray is now featuring a green symbol.

_Once connected to the VPN, the procedure for accessing your Sandbox is unchanged, and still makes use of your private keys with SSH access (cf. [[vm access|SSH Connexion]])._

h2. Nota bene

h3. Manual setup on other platforms

To download the "OpenVPN Connect" client for installation on another computer, you can access installation material and configuration templates from here:

https://cloud.terradue.com:1194

Selecting "Connect" sends you to the initial prompt page, described above (for automated setup on your computer).

h3. Command Line Interface

Some users need to use the OpenVPN's command line interface. 

This last possibility is useful, because the "openvpn" command, which you can execute by using the prompt (Unix Shell or Windows Prompt) accepts the same parameters and has the same behavior regardless of which Operating System you use. 

In addition, you can use the "openvpn" command in a script to automatically start the VPN connection.

The [[OpenVPN Command line]] section describes how to build and install OpenVPN for most of the operating systems, and use it via command lines.