* Your router needs to provide acces to '''UDP port 1194'''. The way to open is through port forwarding. Forward UDP port 1194 from your router to the IP address of your HDA.
On to the clients.:
* [[VPNWindows|WindowsClient]]
* Mac: [[VPNMacTunnelBlick|TunnelBlick]] (open source) or [[VPNMacViscosity|Viscosity]] (shareware)
* [[VPNLinux|Linux]]
= Windows =
* Download the [http://yourhda.com/newuser/hdaconnect.exe HDAConnect installer].
* Note: If you have installed a previous version, you will want to exit and uninstall it first.
* On windows XP simply run it. On Vista, run it as Administrator (this is important). The defaults should work for everyone.
* Click on "Continue Anyway" warning for the driver, if any.
* After installation is done. It will display a small icon in the desktop tray. It may also display a network icon with a red mark indicating "A network cable is disconnected." This is the VPN "network adapter" indicating the VPN is down.<br />[[Image:vpn-taskbar.png]]
* Any time you want to connect, simply double click in the icon. A Menu like this will come up<br />[[Image:connect-menu.png]]
* In it, input
** The nickname of the HDA you want to connect to
** Your username in that HDA, and
** The password of the user in that HDA
= Mac =
For the Mac, we recommend using the [http://www.tunnelblick.net/ Tunnelblick] client.
* Download and install [http://www.tunnelblick.net/Tunnelblick_3.0_B4.zip Tunnelblick 3.0(B4)] for Mac OS X 10.4.
* There are some .ctr/.key files needed:
** [[:Image:AmahiHDAClient.crt|AmahiHDAClient.crt]]
** [[:Image:AmahiHDAClient.key|AmahiHDAClient.key]]
** [[:Image:ca-cert.crt|ca-cert.crt]]
* Download the .ctr/.key files and save them in the /Users/'''username'''/Library/openvpn folder, where '''username''' is the home directory of the current user.
* Go to the configuration for Tunnelblick and edit the config file.
* Click on the Tunnelblick icon in the upper right corner of the display, then click '''''Details...'''''<br />[[Image:tunnelblick-pulldown.png]]
* "OpenVPN Log Output" window should appear, click on '''''Edit Configuration'''''. Make sure the ''Set Nameserver (Experimental)'' option is ''checked.''<br />[[Image:tunnelblick-editconfig.png]]
* Delete the default sample configuration<br />[[Image:openvpn_conf1.png]]
* Copy and paste the configuration below into the OpenVPN.conf file, replacing XYZ for your HDA's nickname:
<pre><nowiki>
remote XYZ.yourhda.com 1194
client
dev tun
proto udp
resolv-retry infinite
nobind
persist-key
persist-tun
ca ca-cert.crt
cert AmahiHDAClient.crt
key AmahiHDAClient.key
comp-lzo
verb 3
auth-user-pass
</nowiki></pre>
* Any time you want to connect '''from outside of your home network''' and '''into your home network''', simply click on '''Connect'''
* Don't forget to click on the DNS option.
* Input your username and password
* It is possible to use keyrings. Will link here the details when available.
Note:
* The procedure above has been tested with an Intel-based Mac.
* If the latest does not work, try the Beta 3 of Tunneblick: [http://www.tunnelblick.net/Tunnelblick_3.0_rc3.zip Tunnelblick_3.0_rc3.zip]
= Linux =
The instructions for Linux are similar to the mac. This is the script to use (replacing XYZ for the nickname of the HDA you are trying to connect to):
<pre><nowiki>
remote XYZ.yourhda.com 1194
client
dev tun
proto udp
resolv-retry infinite
nobind
persist-key
persist-tun
ca ca-cert.crt
cert AmahiHDAClient.crt
key AmahiHDAClient.key
comp-lzo
verb 3
auth-user-pass
</nowiki></pre>
