tahoe-lafs/docs/install.html

<!DOCtype HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
  <head>
    <title>Installing Tahoe</title>
    <link rev="made" class="mailto" href="mailto:zooko[at]zooko[dot]com">
    <meta name="description" content="how to install Tahoe">
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <meta name="keywords" content="tahoe secure decentralized filesystem installation">
  </head>

  <body>
    <h1>About Tahoe</h1>
    <p>Welcome to <a href="http://allmydata.org">the Tahoe project</a>, a secure, decentralized, fault-tolerant filesystem.</p>
    <p>See <a href="about.html">the about page</a> for more information.

    <h1>
    <h1>How To Install Tahoe</h1>

    <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>

    <h2>Satisfy the Dependencies</h2>

    <p>Prior to installing Tahoe ensure that the following are installed:

      <ol>
	<li><a href="http://gcc.gnu.org/">g++</a> &gt;= 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</li>

	<li><a href="http://gnu.org/software/make/">GNU make</a></li>

	<li><a href="http://python.org">Python</a> &gt;= v2.4.2 including development headers i.e. "Python.h"</li>
      </ol>


    <h2>Get the Source Code</h2>

      <p>Download a recent release tarball file from:</p>

      <pre><a
      href="http://allmydata.org/source/tahoe/releases">http://allmydata.org/source/tahoe/releases</a></pre>

      <p>The larger <tt>-SUMO</tt> 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 <tt><a
      href="http://allmydata.org/source/tahoe/deps/tahoe-deps.tar.gz">http://allmydata.org/source/tahoe/deps/tahoe-deps.tar.gz</a></tt>
      bundle.</p>


    <h2>Build Tahoe</h2>

    <p>Unpack the tarball and cd into the top-level directory.</p>

    <p>Run <cite>make</cite> to build and to install the <cite>tahoe</cite> executable into a subdirectory of the current directory named <cite>bin</cite>.</p>

    <p>Run <cite>make test</cite> to verify that it built correctly and passes all tests.</p>

    <p>Run <cite>bin/tahoe --version</cite> 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).</p>

    <h2>Run</h2>

    <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>


    <h2>More Details</h2>

    <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.</p>

  </body>
</html>
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`<!DOCtype HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">`
			`<html lang="en">`
			`<head>`
docs: update install.html and update and format running.html 2008-01-02 00:20:07 +00:00			`<title>Installing Tahoe</title>`
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`<link rev="made" class="mailto" href="mailto:zooko[at]zooko[dot]com">`
docs: update install.html and update and format running.html 2008-01-02 00:20:07 +00:00			`<meta name="description" content="how to install Tahoe">`
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`<meta http-equiv="Content-Type" content="text/html; charset=utf-8">`
			`<meta name="keywords" content="tahoe secure decentralized filesystem installation">`
			`</head>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`<body>`
more introductory doc cleanup mv README to docs/about.html and reformat it as HTML add a new README which is a text file pointing to docs/{about,install,running}.html include the Transitive Grace Period Public Licence in its HTML form (it is too big) 2008-01-05 01:09:19 +00:00			`<h1>About Tahoe</h1>`
setup and docs: various improvements to setup and docs Remove docs/install-details.html and README.win32 for now (see #282). Remove checks for pywin32 and pyopenssl in Makefile -- that is (or will be) automated by setuptools. Remove twisted from setup_requires. This causes the problem in which Nevow doesn't declare its dependency on Twisted (#440) to yield a clear ImportError mentioning Twisted and to fail repeatedly, rather than yielding a weird ImportError and working on the second identical attempt. Fix Makefile to set PATH so that trial and twistd can be found by "make test" after Twisted was installed into support/ during "make" 2008-06-05 20:55:05 +00:00			`<p>Welcome to <a href="http://allmydata.org">the Tahoe project</a>, a secure, decentralized, fault-tolerant filesystem.</p>`
docs: edit install.html to point to about.html 2008-01-23 15:08:10 +00:00			`<p>See <a href="about.html">the about page</a> for more information.`
more introductory doc cleanup mv README to docs/about.html and reformat it as HTML add a new README which is a text file pointing to docs/{about,install,running}.html include the Transitive Grace Period Public Licence in its HTML form (it is too big) 2008-01-05 01:09:19 +00:00
			`<h1>`
docs: update install.html and update and format running.html 2008-01-02 00:20:07 +00:00			`<h1>How To Install Tahoe</h1>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
setup: edit the text of install.html 2008-09-08 21:55:49 +00:00			`<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>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
setup: edit the text of install.html 2008-09-08 21:55:49 +00:00			`<h2>Satisfy the Dependencies</h2>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: edit to install.html suggested by Brian 2008-05-06 19:31:15 +00:00			`<p>Prior to installing Tahoe ensure that the following are installed:`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`<ol>`
doc: mention that "Mac Developer Tools" is the way to get gcc/g++ for Mac 2008-06-10 23:19:34 +00:00			`<li><a href="http://gcc.gnu.org/">g++</a> >= 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</li>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
setup: remove the developer note about doing without GNU make (the GNU make requirement is about to hurt Peter if he tries to follow this doc, by the way) add classifiers showing with which versions of Python it is known to work. 2008-10-21 16:32:00 +00:00			`<li><a href="http://gnu.org/software/make/">GNU make</a></li>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: add require version numbers of deps to install.html, move pywin32 from install.html to install-details.html, change ref to install-details.html in install.html 2008-01-10 20:35:30 +00:00			`<li><a href="http://python.org">Python</a> >= v2.4.2 including development headers i.e. "Python.h"</li>`
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`</ol>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00

setup: edit the text of install.html 2008-09-08 21:55:49 +00:00			`<h2>Get the Source Code</h2>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: mention -SUMO tarballs, point users at release tarballs instead of development ones 2008-09-17 20:36:31 +00:00			`<p>Download a recent release tarball file from:</p>`

			`<pre><a`
			`href="http://allmydata.org/source/tahoe/releases">http://allmydata.org/source/tahoe/releases</a></pre>`

			`<p>The larger <tt>-SUMO</tt> 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 <tt><a`
Makefile,docs: tahoe-deps.tar.gz now lives in separate source/deps/ directory on http://allmydata.org 2008-09-17 20:44:52 +00:00			`href="http://allmydata.org/source/tahoe/deps/tahoe-deps.tar.gz">http://allmydata.org/source/tahoe/deps/tahoe-deps.tar.gz</a></tt>`
docs: mention -SUMO tarballs, point users at release tarballs instead of development ones 2008-09-17 20:36:31 +00:00			`bundle.</p>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00

setup: edit the text of install.html 2008-09-08 21:55:49 +00:00			`<h2>Build Tahoe</h2>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`<p>Unpack the tarball and cd into the top-level directory.</p>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
setup: edit the text of install.html 2008-09-08 21:55:49 +00:00			`<p>Run <cite>make</cite> to build and to install the <cite>tahoe</cite> executable into a subdirectory of the current directory named <cite>bin</cite>.</p>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`<p>Run <cite>make test</cite> to verify that it built correctly and passes all tests.</p>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: update install.html to reflect Justin's user test 2008-06-11 02:04:58 +00:00			`<p>Run <cite>bin/tahoe --version</cite> 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).</p>`
docs: a couple of improvements to install.html 2008-01-01 08:52:50 +00:00
docs: update install.html and update and format running.html 2008-01-02 00:20:07 +00:00			`<h2>Run</h2>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
docs: edits to [source:docs/install.html] and [source:docs/running.html] 2008-06-11 02:22:00 +00:00			`<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>`
docs: a bunch of updates to simplify the process of installing from source and running Tahoe These changes are a work-in-progress -- there are many incomplete and incorrect parts, but the install.html and running.html files are complete and should work (and they are delightfully concise!). I'm pushing this just to let people see incremental progress and to solicit feedback. "Testing out" the install.html and running.html files and submitting patches or bug reports would be quite welcome. More to come. 2007-12-30 12:47:17 +00:00
setup: add link to the DownloadDebianPackages page Because I want that link off of the front page of the wiki... 2008-09-08 21:54:51 +00:00
docs/install.html: reference InstallDetails instead of debian-specific stuff 2008-09-17 22:57:42 +00:00			`<h2>More Details</h2>`
setup: add link to the DownloadDebianPackages page Because I want that link off of the front page of the wiki... 2008-09-08 21:54:51 +00:00
docs/install.html: reference InstallDetails instead of debian-specific stuff 2008-09-17 22:57:42 +00:00			`<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.</p>`
setup: add link to the DownloadDebianPackages page Because I want that link off of the front page of the wiki... 2008-09-08 21:54:51 +00:00
docs: format install.html into HTML format 2007-12-31 03:01:18 +00:00			`</body>`
			`</html>`