<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.docbook.org/xml/4.4/docbookx.dtd">
<article>
  <articleinfo>
    <title>FreedomBox/Manual/OpenVPN</title>
    <revhistory>
      <revision>
        <revnumber>8</revnumber>
        <date>2016-12-31 04:01:13</date>
        <authorinitials>JamesValleroy</authorinitials>
        <revremark>clarify install vs setup</revremark>
      </revision>
      <revision>
        <revnumber>7</revnumber>
        <date>2016-09-09 15:37:55</date>
        <authorinitials>SunilMohanAdapa</authorinitials>
        <revremark>Minor indentation fix with screenshot</revremark>
      </revision>
      <revision>
        <revnumber>6</revnumber>
        <date>2016-09-01 19:14:03</date>
        <authorinitials>Drahtseil</authorinitials>
        <revremark>adapted title to Plinth wording</revremark>
      </revision>
      <revision>
        <revnumber>5</revnumber>
        <date>2016-08-14 19:39:09</date>
        <authorinitials>JanCostermans</authorinitials>
        <revremark>added screenshot and setting up sections</revremark>
      </revision>
      <revision>
        <revnumber>4</revnumber>
        <date>2016-04-10 07:16:50</date>
        <authorinitials>PhilippeBaret</authorinitials>
        <revremark>Added bottom navigation link</revremark>
      </revision>
      <revision>
        <revnumber>3</revnumber>
        <date>2015-12-16 00:32:58</date>
        <authorinitials>PhilippeBaret</authorinitials>
        <revremark>Text finishing</revremark>
      </revision>
      <revision>
        <revnumber>2</revnumber>
        <date>2015-12-16 00:28:34</date>
        <authorinitials>PhilippeBaret</authorinitials>
        <revremark>Added definition for OpenVPN</revremark>
      </revision>
      <revision>
        <revnumber>1</revnumber>
        <date>2015-12-15 23:58:42</date>
        <authorinitials>PhilippeBaret</authorinitials>
        <revremark>Added first content [OpenVPN page to Apps manual]</revremark>
      </revision>
    </revhistory>
  </articleinfo>
  <section>
    <title>Virtual Private Network (OpenVPN)</title>
    <section>
      <title>What is OpenVPN?</title>
      <para>OpenVPN provides to your FreedomBox a virtual private network service. You can use this software for remote access, site-to-site VPNs and Wi-Fi security. OpenVPN includes support for dynamic IP addresses and NAT. </para>
    </section>
    <section>
      <title>Setting up</title>
      <orderedlist numeration="arabic">
        <listitem>
          <para>In Plinth apps menu, select <emphasis>Virtual Private Network (OpenVPN)</emphasis> and click Install. </para>
        </listitem>
        <listitem>
          <para>After the module is installed, there is an additional setup step that may take a long time to complete. Click "Start setup" to begin. </para>
          <para>
            <inlinemediaobject>
              <imageobject>
                <imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/OpenVPN?action=AttachFile&amp;do=get&amp;target=plinth_openvpn.png"/>
              </imageobject>
              <textobject>
                <phrase>plinth_openvpn.png</phrase>
              </textobject>
            </inlinemediaobject>
          </para>
        </listitem>
        <listitem>
          <para>Wait for the setup to finish. This could take a while. </para>
        </listitem>
        <listitem>
          <para>Once the setup of the OpenVPN server is complete, you can download your profile. This will download a file called &lt;USER&gt;.ovpn, where &lt;USER&gt; is the name of a FreedomBox user. Each FreedomBox user will be able to download a different profile. </para>
        </listitem>
        <listitem>
          <para>The ovpn file contains all the information a vpn client needs to connect to the server. </para>
        </listitem>
        <listitem>
          <para>If you are behind a modem, you may have to change the ip address (if not, you can skip this step). Open the ovpn file in any text editor. The second line shows the IP address or hostname the client will try to connect to.  This should be your WAN IP address or your hostname. This line also contains the port number, 1194 being the default. You may have to open this port on your modem and enable port forwarding.  </para>
        </listitem>
      </orderedlist>
      <screen><![CDATA[client
remote mybox.sds-ip.de 1194
proto udp]]></screen>
      <orderedlist numeration="arabic">
        <listitem>
          <para>Install an OpenVPN client for your system </para>
        </listitem>
        <listitem>
          <para>Open the ovpn file with the OpenVPN client. </para>
        </listitem>
        <listitem>
          <para>Try to ping the FreedomBox or other devices on the local network. </para>
        </listitem>
      </orderedlist>
    </section>
    <section>
      <title>External Links</title>
      <para>
        <ulink url="https://openvpn.net/index.php/open-source/overview.html"/>
      </para>
      <!--rule (<hr>) is not applicable to DocBook-->
      <informaltable>
        <tgroup cols="8">
          <colspec colname="col_0"/>
          <colspec colname="col_1"/>
          <colspec colname="col_2"/>
          <colspec colname="col_3"/>
          <colspec colname="col_4"/>
          <colspec colname="col_5"/>
          <colspec colname="col_6"/>
          <colspec colname="col_7"/>
          <tbody>
            <row rowsep="1">
              <entry colsep="1" rowsep="1">
                <para>
                  <emphasis role="strong">Information</emphasis>
                </para>
              </entry>
              <entry colsep="1" rowsep="1"/>
              <entry colsep="1" rowsep="1"/>
              <entry colsep="1" rowsep="1">
                <para>
                  <emphasis role="strong">Support</emphasis>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <emphasis role="strong">Work Space</emphasis>
                </para>
              </entry>
              <entry colsep="1" rowsep="1"/>
              <entry colsep="1" rowsep="1">
                <para>
                  <emphasis role="strong">Reports</emphasis>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <emphasis role="strong">Promote</emphasis>
                </para>
              </entry>
            </row>
            <row rowsep="1">
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Introduction#">Overview</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Hardware#">Hardware</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <emphasis role="strong"> </emphasis>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Support#">Live Help</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Contribute#">Where To Start</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Translate#">Translate</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/ProgressCalls#">Calls</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/TalksAndPresentations#">Talks</ulink>
                </para>
              </entry>
            </row>
            <row rowsep="1">
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Features#">Features</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Vision#">Vision</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <emphasis role="strong"> </emphasis>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/QuestionsAndAnswers#">Q&amp;A</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Design#">Design</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/TODO#">To Do</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Metrics#">Metrics</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Press#">Press</ulink>
                </para>
              </entry>
            </row>
            <row rowsep="1">
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Download#">Download</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Manual#">Manual</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <emphasis role="strong"> </emphasis>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/UserExperience#">Use cases</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Contribute/Code#">Code</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Contributors#">Contributors</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/ReleaseNotes#">Releases</ulink>
                </para>
              </entry>
              <entry colsep="1" rowsep="1">
                <para>
                  <ulink url="https://wiki.debian.org/FreedomBox/Manual/OpenVPN/FreedomBox/Blog#">Blog</ulink>
                </para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <!--rule (<hr>) is not applicable to DocBook-->
      <para>
      </para>
    </section>
  </section>
</article>
