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:

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
GNU make (DEVELOPER NOTE: Oh boy, we're close to removing this dependency from this document! See http://allmydata.org/trac/tahoe/ticket/505 and http://allmydata.org/trac/tahoe/ticket/506. Note that Tahoe hackers may want to continue to use the Makefile even if it is no longer necessary to build and test and launch Tahoe.)
Python >= v2.4.2 including development headers i.e. "Python.h"

Get the Source Code

Download a recent tarball file from:

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

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.

Alternate Install Process For Debian/Ubuntu

If you prefer to install Tahoe in .deb packages, please see the DownloadDebianPackages page on the wiki instead of following the instructions on this page.