= Debian Packages =

[http://allmydata.org/source/tahoe/trunk/docs/install.html ""Install Tahoe""] 
tells how to build Tahoe from source.

Precompiled Tahoe packages are also available for Debian-like systems, using
recent releases of Debian or Ubuntu. There are also precompiled packages for
several of the necessary support libraries which are not already in the
debian distribution:

 * debian "etch": Tahoe and support libraries
 * debian "lenny" (not yet released): use "etch"
 * debian "sid": support libaries only, use "etch" for the Tahoe package

 * ubuntu "dapper": not supported since tahoe-0.4.0 (July 2007)
 * ubuntu "edgy": Tahoe and support libraries
 * ubuntu "feisty": Tahoe and support libraries
 * ubuntu "gutsy": Tahoe and support libraries
 * ubuntu "hardy": Tahoe and support libraries

allmydata.org hosts an APT repository at http://allmydata.org/debian/ . To
install packages from this repository, add the following lines to your
{{{/etc/apt/sources.list}}}, replacing the word {{{$DIST}}} with one of
{{{etch}}}, {{{sid}}}, {{{edgy}}}, {{{feisty}}}, or {{{gutsy}}} as
appropriate.

{{{
deb http://allmydata.org/debian/  $DIST  main tahoe
deb-src http://allmydata.org/debian/  $DIST  main tahoe
}}}


Then update and install the {{{allmydata-tahoe}}} package. apt-get will
automatically acquire other dependency packages from the same repository
(including {{{foolscap}}}, {{{zfec}}}, {{{pycryptopp}}}, and others. The
"tahoe" section contains the Tahoe debian packages, while the "main" section
contains the support libraries.

Note that these {{{allmydata-tahoe}}} packages are generated each time the
code is changed, and represent the most up-to-date (read "unstable") version
available. The usual warnings about no guarantees apply: it might cause your
computer to catch fire, might steal your dog, etc.

In the future, we will add a section to the repository that only contains
released versions of Tahoe, probably called "tahoe-releases". The packages in
this section should be more stable than the bleeding-edge packages in the
"tahoe" section.

After installing see the [http://allmydata.org/source/tahoe/trunk/docs/running.html docs/running.html] for how to use it.

There are no pre-built packages available for dapper or sarge, as these
releases are too old to provide the necessary support packages
(python-central, setuptools, etc). You can probably still install from source
on these releases, however.

== Problems ==

=== Edgy ===

While the tahoe package on edgy will install, it appears that the version of
Nevow (0.7.0) which shipped with edgy is broken (ubuntu bug
[https://bugs.launchpad.net/ubuntu/+source/nevow/+bug/61423 #61423]),
preventing the tahoe node's webserver from running. The symptom is an
exception at node startup that looks like this:

{{{
  File "/var/lib/python-support/python2.4/formless/annotate.py", line 17, in ?
     from nevow.compy import Interface, MetaInterface
exceptions.ImportError: cannot import name MetaInterface
}}}

We do not yet know of a solid workaround for this. One suggestion is to
comment out the "from allmydata.webish import WebishServer" line from
allmydata/client.py and not use the 'webport' feature. Another is to modify
formless/annotate.py and try to fix that import problem. A third is to find a
backport of a newer version of nevow.

=== Sid ===

The combination of Twisted-8.x and pyopenssl-0.7 triggers a bug (#402) that
causes many unit tests to fail. This bug does not appear to impact actual
operations. The current workaround is to downgrade to pyopenssl-0.6 or
refrain from running unit tests.

== Building From Source On Debian Systems ==

Many of Tahoe's build dependencies can be satisfied by first installing
certain debian packages, and the Tahoe build process will download and build
many of the others. Please see source:docs/debian.txt for details about
building Tahoe on a debian-based system.

== Building a Debian Package ==

Please see source:docs/debian.txt for details about building your own debian
packages from a Tahoe source tree.

Note that this is entirely optional. Tahoe will run just fine from a source
tree: creating a debian package is merely a convenience for sysadmins to help
them manage large numbers of Tahoe nodes with established tools like apt-get.