1 <!DOCtype HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <style type="text/css">
6 p.p1 {font-style:italic;}
8 <title>Getting Tahoe-LAFS</title>
9 <link rev="made" class="mailto" href="mailto:zooko[at]zooko[dot]com">
10 <meta name="description" content="how to get Tahoe-LAFS">
11 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
12 <meta name="keywords" content="tahoe-lafs secure decentralized filesystem installation">
16 <h1>About Tahoe-LAFS</h1>
17 <p> The homepage of Tahoe-LAFS is <a href="http://tahoe-lafs.org">
18 http://tahoe-lafs.org</a>. There is a one-page overview at <a href="about.html">
21 <h1>How To Get Tahoe-LAFS</h1>
23 <p class=p1>This has been verified to work on Windows, Mac, OpenSolaris,
24 and too many flavors of Linux and of *BSD to list. It's likely to work on
27 <p class=p1><strong>WARNING!</strong> There are a few third-party
28 libraries that Tahoe-LAFS depends on that might not be easy to set up on
29 your platform. If the following instructions don't Just Work, please write
30 to <a href="http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev">the
31 tahoe-dev mailing list</a> where fun, friendly, hackers will help you out!
32 You might also find clues in the Advanced Installation section below.</p>
34 <h2>Install Python</h2>
36 <p>Check if you already have an adequate version of Python installed by
37 running <cite>python --version</cite>. Python v2.4 (v2.4.4 or
38 greater), Python v2.5, Python v2.6, or Python v2.7 will
39 work. Python v3 does not work. On Windows, we recommend the use of
40 Python v2.6 (native, not Cygwin).</p>
42 <p>If you don't have one of these versions of Python installed, then
43 follow the instructions on
44 <a href="http://www.python.org/download/releases/2.6.6/">the Python
45 download page</a> to download and install Python v2.6. Make sure
46 that the path to the installation directory has no spaces in it (e.g. on
47 Windows, do not install Python in the "<tt>Program Files</tt>" directory).
50 <h2>Get Tahoe-LAFS</h2>
52 <p>Download the latest stable release, v1.8.2:</p>
54 href="http://tahoe-lafs.org/source/tahoe-lafs/releases/allmydata-tahoe-1.8.2.zip">http://tahoe-lafs.org/source/tahoe-lafs/releases/allmydata-tahoe-1.8.2.zip</a></pre>
56 <h2>Set Up Tahoe-LAFS</h2>
58 <p>Unpack the zip file and cd into the top-level directory.</p>
60 <p>Run <cite>python setup.py build</cite> to generate the <cite>tahoe</cite>
61 executable in a subdirectory of the current directory named <cite>bin</cite>.
62 This will download and build anything you need from various websites.</p>
64 <p>On Windows, the <cite>build</cite> step might tell you to open a new
65 Command Prompt (or, on XP and earlier, to log out and back in again).
66 This is needed the first time you set up Tahoe-LAFS on a particular
67 installation of Windows.</p>
69 <p>Optionally run <cite>python setup.py test</cite> to verify that it
70 passes all of its self-tests.</p>
72 <p>Run <cite>bin/tahoe --version</cite> (on Windows,
73 <cite>bin\tahoe --version</cite>) to verify that the executable tool prints
74 out the right version number.</p>
76 <h2>Run Tahoe-LAFS</h2>
78 <p>Now you are ready to deploy a decentralized filesystem. The
79 <cite>tahoe</cite> executable in the <cite>bin</cite> directory can
80 configure and launch your Tahoe-LAFS nodes.
81 See <a href="running.html">running.html</a> for instructions on how to do
85 <h2>Advanced Installation</h2>
87 <p>For optional features such as tighter integration with your operating
88 system's package manager, you can see the
89 <a href="http://tahoe-lafs.org/trac/tahoe/wiki/AdvancedInstall">AdvancedInstall</a>
90 wiki page. The options on that page are not necessary to use Tahoe-LAFS
91 and can be complicated, so we do not recommend following that page unless
92 you have unusual requirements for advanced optional features. For most
93 people, you should first follow the instructions on this page, and if that
94 doesn't work then ask for help by writing to
95 <a href="http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev">the
96 tahoe-dev mailing list</a>.</p>