About Tahoe

Welcome to the Tahoe project, a secure, decentralized, fault-tolerant filesystem.

See the about page for more information.

How To Install Tahoe

This procedure has been verified to work on Windows, Cygwin, Mac, Linux, Solaris, and FreeBSD. It's likely to work on other platforms. If you have trouble with this install process, please write to the tahoe-dev mailing list, where friendly hackers will help you out.

Satisfy the Dependencies

Prior to installing Tahoe ensure that the following are installed:

  1. g++ >= v3.3 -- the "Cygwin" version of gcc/g++ works for Cygwin and for Windows; the "Mac Developer Tools" version of gcc/g++ works for Mac
  2. GNU make
  3. Python >= v2.4.2 including development headers i.e. "Python.h"

Get the Source Code

Download a recent release tarball file from:

http://allmydata.org/source/tahoe/releases

The larger -SUMO tarballs include all the automatically-installable dependencies; use the smaller regular tarball if you don't mind the build process downloading the things it needs, or if you've downloaded and unpacked the http://allmydata.org/source/tahoe/deps/tahoe-deps.tar.gz bundle.

Build Tahoe

Unpack the tarball and cd into the top-level directory.

Run make to build and to install the tahoe executable into a subdirectory of the current directory named bin.

Run make test to verify that it built correctly and passes all tests.

Run bin/tahoe --version to verify that the executable tool runs and prints out the right version number (the "allmydata" version number is the version number of the Tahoe package).

Run

Now you have the Tahoe source code installed and are ready to use it to form a decentralized filesystem. The tahoe executable in the bin directory can configure and launch your Tahoe node. See running.html for instructions on how to do that.

More Details

For more details, including platform-specific hints for debian, windows, and Mac systems, please see the InstallDetails wiki page.