• use out-of-line links to avoid a warning from rst2html --verbose (fixes #1704) • reflow to 77 fill-column and prepend utf-8 BOM (fixes #1703) • recommend Python 2.7 (fixes #1702) • remove link to wiki:AdvancedInstall (fixes #1701)
2.6 KiB
Getting Tahoe-LAFS
Welcome to the Tahoe-LAFS project, a secure, decentralized, fault-tolerant storage system.
How To Get Tahoe-LAFS
This procedure has been verified to work on Windows, Mac, OpenSolaris, and too many flavors of Linux and of BSD to list. It's likely to work on other platforms.
In Case Of Trouble
There are a few 3rd party libraries that Tahoe-LAFS depends on that might not be easy to set up on your platform. If the following instructions don't Just Work without any further effort on your part, then please write to the tahoe-dev mailing list where friendly hackers will help you out.
Install Python
Check if you already have an adequate version of Python installed by running python -V
. Python v2.4 (v2.4.4 or greater), Python v2.5, Python v2.6, or Python v2.7 will work. Python v3 does not work. On Windows, we recommend the use of native Python, not Cygwin. If you don't have one of these versions of Python installed, download and install Python v2.7. Make sure that the path to the installation directory has no spaces in it (e.g. on Windows, do not install Python in the "Program Files" directory).
Get Tahoe-LAFS
Download the latest stable release, Tahoe-LAFS v1.9.1.
Set Up Tahoe-LAFS
Unpack the zip file and cd into the top-level directory.
Run python setup.py build
to generate the tahoe
executable in a subdirectory of the current directory named bin
. This will download and build anything you need from various websites.
On Windows, the build
step might tell you to open a new Command Prompt (or, on XP and earlier, to log out and back in again). This is needed the first time you set up Tahoe-LAFS on a particular installation of Windows.
Optionally run python setup.py test
to verify that it passes all of its self-tests.
Run bin/tahoe --version
(on Windows, bin\tahoe --version
) to verify that the executable tool prints out the right version number.
Run Tahoe-LAFS
Now you are ready to deploy a decentralized filesystem. The tahoe
executable in the bin
directory can configure and launch your Tahoe-LAFS nodes. See running.rst for instructions on how to do that.