This is not a polished article, I wrote this before as my personal notes and for me to share it to anyone who would like to experiment IPv6 in their homes.

So since its World IPv6 Day today, I decided to just copy and paste it here. These are steps on how to create an IPv6 tunnel from your home PC or laptop using the gogo6 client software.

You can install and run gogo6 client in Windows, BSD, Linux and MacOSes but the steps here are tried and tested in my Ubuntu 10.04 Linux PC.

Create freenet6.net Account

1. go to http://gogonet.gogo6.com/page/freenet6-registration

2. fill up the following

Desired Userid
Email Address
Password
Confirm Password

3. click Submit

Download the gogoCLIENT software

1. go to http://gogonet.gogo6.com/profile/gogoCLIENT

2. choose the appropriate installer you need depending on your OS

3. for ubuntu, download gogoCLIENT 1.2 Source Code (Linux/Unix/MacOS/BSD)

Installation

1. extract the gogoc-1_2-RELEASE.tar.gz:

# tar xzvf gogoc-1_2-RELEASE.tar.gz

2. go to gogoc-1_2-RELEASE directory

3. read the INSTALL file first and check whether you already have installed the dependencies in your system.

To build the gogoCLIENT, your system must support a Unix-like command-line development environment, including the text-processing utilities (sh, grep, awk, sed, etc.) and a functional GNU C and C++ compiler. On some GNU/Linux systems, this means that you will need to install packages such as `gcc', `g++', `glibc-devel' (or `libc6-dev') and `gmake'. Most systems come with these packages preinstalled, but it doesn't hurt to check. If you have successfully compiled other software from source, you probably have them all.

In addition to the C and C++ development environment, the gogoCLIENT can use a number of libraries to provide additional features, such as encrypted authentication. The “external” dependencies include:

OpenSSL – for encryption routines.
libcrypto – for encryption routines.
libpthread – for POSIX threading.
libsocket, libnsl – for SOLARIS platforms only.
GNU make.
To be usable for building the gogoCLIENT, the listed libraries must be installed with their “development” header files. On GNU/Linux systems this typically means installing the corredponsing “lib-devel” or “lib-dev” package along with the package with “lib”.

In my case, when I tried to install gogoCLIENT, i installed first libssl-dev

# apt-get install libssl-dev

4. make platform=linux all

5. make platform=linux installdir=/usr/local/gogoc install

NOTE: Before running gogoCLIENT, check your email address to see if your account was approved.

Running gogoCLIENT

1. go to /usr/local/gogoc/bin

2. Edit gogoc.conf and change the following fields:

userid= password=
server=authenticated.freenet6.net
auth_method=any
host_type=host
prefixlen=64
if_prefix=
dns_server=disco.gogo6.com:music.gogo6.com
gogoc_dir=/usr/local/gogoc

3. run gogoc:

# ./gogoc

4. check if you already have ipv6

# ifconfig

EXPECTED: You should have tun interface listed with ipv6 address inet6 addr: 2001:5c0:1400:b::xxxx/128 Scope:Global

Unfortunately, this site is hosted in an IPv4 only server. But still, I hope you now got your IPv6 tunnel up and running by following the steps above. Enjoy!