The Tahoe-LAFS decentralized secure filesystem.
Go to file
Sajith Sasidharan ab4811eaa0 Move tests for abbreviate time/rate methods to utils tests
RateAndTimeMixin.render_time() is really abbreviate_time(), and
RateAndTimeMixin.render_rate() is really abbreviate_rate().  This
change moves the tests to their rightful place, and exercises them
using the right names.

We're also trying to avoid use of mixins.  RateAndTimeMixin will
eventually go.
2020-05-14 16:09:54 -04:00
.circleci mark PyPy as required in circle-ci 2020-05-06 17:17:23 -06:00
.github Do not install setuptools in pyinstaller step 2020-05-13 12:06:11 -04:00
docs Merge branch 'release-1.14.0-rc0' 2020-05-04 14:23:53 -06:00
integration Don't create the magic-folder directories for each node 2020-04-13 12:13:45 -04:00
misc follow the renaming 2019-09-17 11:36:09 -04:00
newsfragments Merge pull request #717 from sajith/3289.status-publish-nevow-to-twisted-web 2020-05-14 10:09:57 -04:00
nix Update comment about trollius 2020-04-24 21:16:57 -04:00
release-tools refactor more 2018-05-29 13:17:32 -06:00
src/allmydata Move tests for abbreviate time/rate methods to utils tests 2020-05-14 16:09:54 -04:00
static Eliminate mock dependency. 2015-07-17 22:12:25 +01:00
.appveyor.yml coverage wants to play 2020-01-20 13:27:41 -05:00
.coveragerc add --coverage for integration tests 2019-08-06 16:47:43 -06:00
.gitignore Remove some git configuration related to magic-folder 2020-02-13 10:26:48 -05:00
.lgtm.yml Disable another lgtm query. 2018-04-26 15:41:38 -04:00
.travis.yml Add comment re. testing PyInstaller executables 2019-10-07 11:31:29 -04: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 a couple additions to CREDITS 2018-05-18 14:41:48 -06:00
docker-compose.yml add dockerfile for hacking with docker compose file for local environment 2017-09-19 09:25:39 -07:00
Dockerfile Remove $HOME/.cache/ directory after building. 2016-09-26 15:19:04 -07:00
Dockerfile.dev add dockerfile for hacking with docker compose file for local environment 2017-09-19 09:25:39 -07:00
Makefile Remove some top-level packaging related to magic-folders 2020-02-13 10:21:45 -05:00
MANIFEST.in setup.py/MANIFEST.in: include missing files 2017-01-18 16:28:23 -08:00
NEWS.rst update title 2020-03-11 18:41:32 -06:00
pyinstaller.spec Remove characteristic dependency 2020-01-27 13:44:28 -05:00
README.rst Update copyright notice years 2018-09-15 18:26:07 +00:00
relnotes.txt bump version to 1.14.0 and update release notes 2020-03-11 17:38:03 -06:00
setup.cfg make bdist_wheel update the version first 2020-02-04 19:50:03 -05:00
setup.py Drop upper bound on Twisted version 2020-04-17 15:44:39 -04:00
Tahoe.home rename bin/allmydata-tahoe to bin/tahoe. Closes #155. 2007-10-11 03:38:24 -07:00
towncrier.pyproject.toml Fix the issue links 2020-02-07 09:27:02 -05:00
tox.ini Don't install Twisted trunk@HEAD since it doesn't support Python 2 2020-04-13 10:36:54 -04:00
ws_client.py move to different url 2019-03-21 15:00:02 -04: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 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-2018 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.