Installation of Tahoe-LAFS for I2P

1) About

These instructions are I2P specific, for generic documentation see Tahoe-LAFS Docs.

You should have already installed and be familiar with I2P.

We will use the tahoe-i2p-install script created by smeghead for the actual installation.

2) Requirements

Bash or Zsh, GCC, Python 2.5 or 2.6 (not 3.x), Wget. Development headers for Python and OpenSSL. You need about 100MB of free disk space to install.

Unsupported, but same as above plus MinGW or Cygwin and probably lots of spit, glue, duct tape and virgin sacrifices. If you make it work please contribute your changes to this script's maintainer (by doing so you agree to release the work into the public domain) and if they're sane enough they'll be included in the next release.

3) Installation

Create a directory for the installation, we suggest ~/tahoe

    $ mkdir ~/tahoe
    $ cd ~/tahoe

Download the script: tahoe-i2p-install

SHA256 checksum: 1a49050518334ac62204d0530b908a98fd698c53fd69d19d36b226b3ccc82126

Reviewed and PGP signed by duck

Make it executable

    $ chmod u+x tahoe-i2p-install

Show usage information

    $ ./tahoe-i2p-install --help

Perform the actual installation (see usage information from above for additional options)

    $ ./tahoe-i2p-install

You can safely ignore most C / C++ compilation warnings. If you get any errors, please see appendix A.

As suggested by the script, update your environment with PATH and PYTHONPATH. Put these two variables in your ~/.bashrc (or equivalent) to preserve them between shell sessions.

Verify the installation

    $ tahoe --version

This will print the version of Tahoe and depending libraries.

4) Done

If everything went well, you are now the proud owner of Tahoe-LAFS for I2P.

Next will be the configuration of your node(s) specifically for I2P. Continue your journey with the usage manual.

A) Common Errors

error: Python.h: No such file or directory

You need to install the Python development headers. In Linux distributions this is usually the python-dev (Debian / Ubuntu) or python-devel (RedHat / Fedora) package.

error: openssl/ssl.h: No such file or directory

You need to install the OpenSSL development headers. In Linux distributions this is usually the libssl-dev (Debian / Ubuntu) or openssl-devel (RedHat / Fedora) package.