docs/install.html

   1 <!DOCtype HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html lang="en">
   3   <head>
   4     <title>Installing Tahoe</title>
   5     <link rev="made" class="mailto" href="mailto:zooko[at]zooko[dot]com">
   6     <meta name="description" content="how to install Tahoe">
   7     <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   8     <meta name="keywords" content="tahoe secure decentralized filesystem installation">
   9   </head>
  10
  11   <body>
  12     <h1>About Tahoe</h1>
  13     <p>Welcome to <a href="http://allmydata.org">the Tahoe project</a>, a secure, decentralized, fault-tolerant filesystem. <a href="about.html">About Tahoe.</a>
  14
  15     <h1>
  16     <h1>How To Install Tahoe</h1>
  17
  18     <p>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 <a href="http://allmydata.org/cgi-bin/mailman/listinfo/tahoe-dev">the tahoe-dev mailing list</a>, where friendly hackers will help you out.</p>
  19
  20     <h2>Install Python</h2>
  21
  22     <p>Check if you already have an adequate version of Python installed by running <cite>python -V</cite>.  Python v2.5 is best.  Python v2.4 (v2.4.2 or greater) or Python v2.6 should also work, although Tahoe isn't as well-tested on them as it is on Python v2.5.  Python v3 does not work. If you don't have one of these versions of Python installed, then follow the instructions on <a href="http://python.org/download/">the Python download page</a> to download and install Python v2.5.
  23
  24     <h2>Get Tahoe</h2>
  25
  26       <p>Download the 1.4.0 release zip file:</p>
  27
  28       <pre><a
  29       href="http://allmydata.org/source/tahoe/releases/allmydata-tahoe-1.4.0.zip">http://allmydata.org/source/tahoe/releases/allmydata-tahoe-1.4.0.zip</a></pre>
  30
  31     <h2>Build Tahoe</h2>
  32
  33     <p>Unpack the zip file and cd into the top-level directory.</p>
  34
  35     <p>Run <cite>python setup.py build</cite> to install the <cite>tahoe</cite> executable into a subdirectory of the current directory named <cite>bin</cite>.</p>
  36
  37     <p>(Optionally run <cite>python setup.py test</cite> to verify that it passes all of its self-tests.)</p>
  38
  39     <p>Run <cite>bin/tahoe --version</cite> to verify that the executable tool prints out the right version number.</p>
  40
  41     <h2>Run</h2>
  42
  43     <p>Now you have the Tahoe source code installed and are ready to use it to form a decentralized filesystem.  The <cite>tahoe</cite> executable in the <cite>bin</cite> directory can configure and launch your Tahoe node.  See <a href="running.html">running.html</a> for instructions on how to do that.</p>
  44
  45
  46     <h2>More Details</h2>
  47
  48     <p>For more details, including platform-specific hints for Debian, Windows, and Mac systems, please see the <a href="http://allmydata.org/trac/tahoe/wiki/InstallDetails">InstallDetails</a> wiki page. If you are running on Windows, you need to manually install "pywin32", as described on that page.
  49
  50   </body>
  51 </html>