wiki:DownloadDebianPackages

Version 12 (modified by warner, at 2008-06-17T20:47:47Z) (diff)

move some docs out to source:docs/debian.txt

Debian Packages

Precompiled Tahoe packages are 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": coming soon

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