Table Of Contents
Introduction Installation Configuration

Configuration And Usage

On Ubuntu you can just downlad the .deb here

For WindowsXP users who installed OnionCat with the installer, there will be a shortcut to OnionCat on the Desktop and in the Start Menu folder. Just run this file and OnionCat will start to initialize.

Otherwise proceed as described below:

  1. Download OnionCat compile and install it. In your hidden service directory (HiddenServiceDir) there should be a file called hostname. It contains your .onion URL.
  1. Now run OnionCat as root.
    # ocat <your_onion_hostname>
    It will create the TUN device and then change the UID to an unprivileged user immediately.
  2. Go to another shell and run ifconfig. You should now see a TUN device with an IPv6 address assigend. If that's not the case, i.e. there's no IPv6 address, configure it manually (OnionCat currently is a development release). First figure out your IPv6 address by issuing the following command:
    # ocat -i <your_onion_hostname>
    It will output your IPv6 address. Then enter
    # ifconfig tun0 add <your_IPv6_address>/48 up
  3. Test it. We currently provide an OnionCat service on fd87:d87e:eb43:f947:ad24:ec81:8abe:753e and on fd87:d87e:eb43:edb1:8e4:3588:e546:35ca.3 Enter the following command and wait:
    $ ping6 fd87:d87e:eb43:f947:ad24:ec81:8abe:753e
    After some time you sould get ping responses.
    PING fd87:d87e:eb43:f947:ad24:ec81:8abe:753e(fd87:d87e:eb43:f947:ad24:ec81:8abe:753e) 56 data bytes
    64 bytes from fd87:d87e:eb43:f947:ad24:ec81:8abe:753e: icmp_seq=149 ttl=64 time=3387 ms
    64 bytes from fd87:d87e:eb43:f947:ad24:ec81:8abe:753e: icmp_seq=150 ttl=64 time=4418 ms
    64 bytes from fd87:d87e:eb43:f947:ad24:ec81:8abe:753e: icmp_seq=151 ttl=64 time=3669 ms
    64 bytes from fd87:d87e:eb43:f947:ad24:ec81:8abe:753e: icmp_seq=152 ttl=64 time=5650 ms
    The time until you get the first response can be very long! That's the time Tor needs to build the circuit to the hidden service. During our tests this sometimes took more then one minute. Now open your favorite browser and enter the following URL or just click on it: http://[fd87:d87e:eb43:f683:64ac:73f9:61ac:9a00]/ . You should see the OnionCat directory service page "" (If something goes wrong maybe your browser does not understand this kind of IPv6 address escaping but it works with Firefox 2.x for sure.).
  4. Now you should be able to run any application as long as there is OnionCat on both ends. Note that the application must be IPv6-aware.
Last modified 7 years ago Last modified on Aug 7, 2013, 8:25:03 AM