The Tahoe-LAFS decentralized secure filesystem.
Switch branches/tags
Clone or download
meejah Merge pull request #526 from meejah/async-initializers.5
Make the initialization of several core objects more async-friendly

(From the async-initializers.5 branch originally)
Latest commit e40993d Sep 14, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Try less aggressive version pinning Jul 24, 2018
docs add concept of Release Maintainer Aug 21, 2018
integration updated Tor release key Aug 31, 2018
misc Comment out "testing" code... Apr 26, 2018
newsfragments newsfragment Sep 11, 2018
release-tools refactor more May 29, 2018
src/allmydata unused var Sep 11, 2018
static Eliminate mock dependency. Jul 17, 2015
.appveyor.yml appveyor: add _trial_temp/test.log as an "artifact" Mar 30, 2018
.coveragerc tox: add "coverage" environment May 9, 2016
.gitignore add dockerfile for hacking with docker compose file for local environ… Sep 19, 2017
.lgtm.yml Disable another lgtm query. Apr 26, 2018
.travis.yml Switch to TAHOE_LAFS prefix Apr 3, 2018
COPYING.GPL Fix repeated 'the' in license text. Aug 19, 2011
COPYING.TGPPL.rst magic first line tells emacs to use utf8+bom Nov 8, 2013
CREDITS a couple additions to CREDITS May 18, 2018
Dockerfile Remove $HOME/.cache/ directory after building. Sep 26, 2016
Dockerfile.dev add dockerfile for hacking with docker compose file for local environ… Sep 19, 2017
MANIFEST.in setup.py/MANIFEST.in: include missing files Jan 19, 2017
Makefile move tarball generation to tox.ini Mar 27, 2018
NEWS.rst Put updates news inside the main section. Aug 6, 2018
README.rst Add the badge Jun 18, 2018
Tahoe.home rename bin/allmydata-tahoe to bin/tahoe. Closes #155. Oct 11, 2007
docker-compose.yml add dockerfile for hacking with docker compose file for local environ… Sep 19, 2017
pyinstaller.spec Fix PyInstaller builds Mar 29, 2018
relnotes.txt CNAME -> github (because https) May 29, 2018
setup.cfg setup.cfg: remove --find-links Mar 26, 2016
setup.py try with only one extra Aug 6, 2018
towncrier.pyproject.toml A different work-around for the pep 518 mess Aug 6, 2018
tox.ini A different work-around for the pep 518 mess Aug 6, 2018

README.rst

Tahoe-LAFS

Tahoe-LAFS is a Free and Open decentralized cloud storage system. It distributes your data across multiple servers. Even if some of the servers fail or are taken over by an attacker, the entire file store continues to function correctly, preserving your privacy and security.

For full documentation, please see http://tahoe-lafs.readthedocs.io/en/latest/ .

documentation status build status circleci test coverage percentage

INSTALLING

There are three ways to install Tahoe-LAFS.

using OS packages

Pre-packaged versions are available for several operating systems:

  • Debian and Ubuntu users can apt-get install tahoe-lafs
  • NixOS, NetBSD (pkgsrc), ArchLinux, Slackware, and Gentoo have packages available, see OSPackages for details
  • Mac and Windows installers are in development.

via pip

If you don't use an OS package, you'll need Python 2.7 and pip. You may also need a C compiler, and the development headers for python, libffi, and OpenSSL. On a Debian-like system, use apt-get install build-essential python-dev libffi-dev libssl-dev python-virtualenv. On Windows, see docs/windows.rst.

Then, to install the most recent release, just run:

  • pip install tahoe-lafs

from source

To install from source (either so you can hack on it, or just to run pre-release code), you should create a virtualenv and install into that:

  • git clone https://github.com/tahoe-lafs/tahoe-lafs.git
  • cd tahoe-lafs
  • virtualenv --python=python2.7 venv
  • venv/bin/pip install --upgrade setuptools
  • venv/bin/pip install --editable .
  • venv/bin/tahoe --version

To run the unit test suite:

  • tox

You can pass arguments to trial with an environment variable. For example, you can run the test suite on multiple cores to speed it up:

  • TAHOE_LAFS_TRIAL_ARGS="-j4" tox

For more detailed instructions, read docs/INSTALL.rst .

Once tahoe --version works, see docs/running.rst to learn how to set up your first Tahoe-LAFS node.

LICENCE

Copyright 2006-2016 The Tahoe-LAFS Software Foundation

You may use this package under the GNU General Public License, version 2 or, at your option, any later version. You may use this package under the Transitive Grace Period Public Licence, version 1.0, or at your option, any later version. (You may choose to use this package under the terms of either licence, at your option.) See the file COPYING.GPL for the terms of the GNU General Public License, version 2. See the file COPYING.TGPPL for the terms of the Transitive Grace Period Public Licence, version 1.0.

See TGPPL.PDF for why the TGPPL exists, graphically illustrated on three slides.