OpenVPN for Android Setup Guide

This process is very manual at this time. We are working on ways to make it much easier for you to do this as the OpenVPN SSL for Android project grows.

Install needed software

KindleFire users skip the install from google play

  1. Download from here: Open in Google Play
  2. Install via Google Play directly on your mobile device
Creating the OpenVPN Configuration File
  1. Use your text editor* to create a new file. This will be your configuration file.

    *For Mac Mac OS use the “TextEdit” program
    *For Windows use “Notepad”

  2. Copy and paste the following into the text editor.

    #####################################
    # Configuration file for use with #
    # WiTopia's personalVPN service #
    #####################################
    client
    dev tun
    proto udp
    remote vpn.(insert city name here).personalvpn.net 1194
    resolv-retry infinite
    nobind
    persist-key
    persist-tun
    ns-cert-type server
    cipher aes-128-cbc
    comp-lzo
    verb 3
    mute 20
    <ca>
    -----BEGIN CERTIFICATE-----

    -----END CERTIFICATE-----
    </ca>
    mssfix 1450
    <key>
    -----BEGIN RSA PRIVATE KEY-----

    -----END RSA PRIVATE KEY-----
    </key>
    <cert>
    -----BEGIN CERTIFICATE-----

    -----END CERTIFICATE-----
    </cert>

  3. In the “remote” line of the configuration above, you will need to replace the (insert city name here), with the city name of the VPN gateway you want to connect to.Example:
    Chicago, IL would be changed like this.
    vpn.(insert city name here).personalvpn.net
    vpn.chicago.personalvpn.netClick here for the list of available gateways/cities
  4. Leave the file open.

  5. Log in to your account HERE, and go to “My Services”.
  6. Click the button to download the “.ZIP file for manual OpenVPN”

    If you don’t see it, click the plus sign “+” to expand your options.

  7. Save the ZIP file
  8. Find the ZIP file you just downloaded, and extract/unzip the files.
  9. Locate the following files in the folder you just unzipped:
    CNxxxxx.crt
    CNxxxxxx.key
    CA.key

     

  10. Open these files with your text editor (Notepad or TextEdit), using the “open with” command. (Right-click in Windows, or Option+Click in Mac OS). Do not double-click the files.
  11. After you have the files open, copy and paste the contents of each of these 3 files into the config. file you created in step 1 & 2. Read the config file to find the correct place to copy and paste the 3 certificates.
  12. Once you have copied and pasted your 3 certificates, save the file. Choose file > SAVE AS.

Apple users, OSX hides the save as from you. You must hold the option key down when click on File and you will see the Save As.. option.

  1. Give the file a name that you will remember.
  2. When you save the file, make sure that the file extension is “.ovpn”.For example: newyork.ovpn

    You must use the .ovpn extension when saving the file. Do not save the file as “.txt” or any other extension.

    Apple users, OSX tries to force the .txt extension on files. At the bottom of the save as box uncheck the option that says “If no extension provided, use .txt” and then click save.

Loading the configuration on your device

Now that you have installed OpenVPN, and created the config we need to get it on the phone.

Importing Config directly from phone

  1. Attach your device to your computer
  2. Open your file manager (explorer, finder etc) and locate the drive for your mobile device
  3. Create a new folder called “WiTopia VPN” in the main directory
  4. Copy the .ovpn config you made to this folder

Import Config Via Email

  1. Open your email program on your computer
  2. Create a new email, and attach the VPN config to the email
  3. Email the file to yourself
  4. Open the email on your mobile device
  5. Click the attachment to open it
  6. It will ask you to import the config to openVPN, choose YES
Create the VPN Connection on your device
  1. Open the OpenVPN Program
  2. Click VPN Profiles
  3. Click on the “folder” icon in the upper right corner
  4. Locate the “WiTopia VPN” folder you created earlier, and open it
  5. Click on the config you want to import and click select
  6. Once the config loads, click the “disk” icon
  7. You should now see the config in the list of profiles to connect to
Connecting & Disconnecting OpenVPN SSL for Android
  1. Open the openVPN program
  2. Click on the vpn profil you want to connect to
  3. If asked, click the “I trust this application” button
  4. Once connected you will see a lock icon in the top left corner indicating the vpn is connected.

You can pull down and click on the vpn for IP details and to disconnect.

Troubleshooting & Logs

If you are having issues connecting please send us the logs. The logs are helpful so we can see what is happening and help diagnose the issue and resolve the issue quickly for you.

  1. When you are connected, or connecting it will output a log to the screen
  2. click your option button (usually the first button on the bottom) and choose send log file
  3. This will bring up a menu of choices. Choose your email and email us the log