The Tahoe-LAFS decentralized secure filesystem.
Go to file
2017-08-12 21:21:04 -07:00
docs Add 'tahoe invite' and 'tahoe create-node --join' commands 2017-08-08 18:27:06 -06:00
integration Add 'tahoe invite' and 'tahoe create-node --join' commands 2017-08-08 18:27:06 -06:00
misc Get rid of unused names 2017-08-08 08:30:32 -04:00
src/allmydata dictutil: remove unused NumDict 2017-08-12 21:21:04 -07:00
static Eliminate mock dependency. 2015-07-17 22:12:25 +01:00
.appveyor.yml appveyor: enable 32-bit, build zipfile of wheels as artifact 2016-12-14 14:18:10 -08:00
.coveragerc tox: add "coverage" environment 2016-05-09 14:32:21 -07:00
.gitignore .gitignore: add .hypothesis/ 2017-06-06 19:04:58 +01:00
.travis.yml travis: only run integration test if the tor install succeeded 2017-08-10 10:00:14 -07:00
COPYING.GPL Fix repeated 'the' in license text. 2011-08-19 13:48:36 -07:00
COPYING.TGPPL.rst magic first line tells emacs to use utf8+bom 2013-11-08 21:08:05 +00:00
CREDITS CREDITS: update 2016-03-30 16:09:12 -07:00
Dockerfile Remove $HOME/.cache/ directory after building. 2016-09-26 15:19:04 -07:00
Makefile make tox env for code-checks 2016-08-19 17:42:05 -07:00
MANIFEST.in setup.py/MANIFEST.in: include missing files 2017-01-18 16:28:23 -08:00
NEWS.rst NEWS/INSTALL/relnotes: release 1.12.1 2017-01-18 16:28:23 -08:00
pyinstaller.spec Add support for binary builds with PyInstaller 2017-08-10 12:43:34 -07:00
README.rst Allow some control over trial command run by tox 2017-07-28 11:05:40 -04:00
relnotes.txt NEWS/INSTALL/relnotes: release 1.12.1 2017-01-18 16:28:23 -08:00
setup.cfg setup.cfg: remove --find-links 2016-03-26 12:23:01 -07:00
setup.py Use find_packages 2017-08-08 12:06:30 -04:00
Tahoe.home rename bin/allmydata-tahoe to bin/tahoe. Closes #155. 2007-10-11 03:38:24 -07:00
tox.ini Add support for binary builds with PyInstaller 2017-08-10 12:43:34 -07:00

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 test coverage percentage

INSTALLING

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.

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

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.