The Tahoe-LAFS decentralized secure filesystem.
Go to file
meejah 7a8ce2e750
Some checks failed
CI / coverage (macos-14, 3.12) (push) Has been cancelled
CI / coverage (ubuntu-22.04, 3.12) (push) Has been cancelled
CI / coverage (ubuntu-22.04, pypy-3.9) (push) Has been cancelled
CI / coverage (windows-2022, 3.12) (push) Has been cancelled
CI / integration (false, macos-14, 3.11) (push) Has been cancelled
CI / integration (false, ubuntu-20.04, 3.11) (push) Has been cancelled
CI / integration (false, windows-2022, 3.11) (push) Has been cancelled
CI / integration (true, ubuntu-20.04, 3.12) (push) Has been cancelled
CI / packaging (macos-14, 3.9) (push) Has been cancelled
CI / packaging (ubuntu-22.04, 3.9) (push) Has been cancelled
CI / packaging (windows-2022, 3.9) (push) Has been cancelled
CI / finish-coverage-report (push) Has been cancelled
Merge pull request #1419 from hacklschorsch/patch-1
Update license / copyright line in README.rst
2024-12-19 21:54:21 -07:00
.circleci final attempt: more timeout for chutney, a comment about (trying to) skip integration failures 2024-12-13 12:12:42 -07:00
.github reviewer doesn't like -latest 2024-12-06 23:44:49 +01:00
benchmarks Make sure FEC does some work 2023-12-06 14:46:37 -05:00
docs update release procedure to reflect reality 2024-12-18 22:37:16 -07:00
integration final attempt: more timeout for chutney, a comment about (trying to) skip integration failures 2024-12-13 12:12:42 -07:00
misc remove more Python2 compatibility 2024-02-28 00:49:07 +01:00
newsfragments (No) news. 2024-12-19 20:19:14 +00:00
nix update nix version 2024-12-14 02:13:08 -07:00
release-tools refactor more 2018-05-29 13:17:32 -06:00
src/allmydata Merge branch 'master' of https://github.com/tahoe-lafs/tahoe-lafs into 1101.feature 2024-12-13 14:07:44 -05:00
static Remove Nevow from the static script 2020-10-21 10:16:44 -04:00
.coveragerc we end up using the coveralls tool to clean up these paths 2023-08-09 14:10:58 -04:00
.gitignore Replace flake8 with ruff. 2023-04-17 10:21:20 -04:00
.pre-commit-config.yaml Revert precommit yaml to previous state 2024-11-29 15:34:47 -05:00
.readthedocs.yaml Use modern Docker image. 2023-05-04 13:10:23 -04:00
.ruff.toml More checks that are probably useful (doesn't trigger anything at the moment). 2023-04-17 13:08:26 -04:00
CONTRIBUTORS.rst Add suggestion for Tahoe Committers 2021-05-07 16:10:24 +02: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 add Florian 2021-12-05 00:53:50 -07:00
default.nix further clarifying comments 2023-07-21 10:24:09 -04:00
flake.lock Update nixpkgs to 24.11, drop test for python39 but add python312 2024-12-05 11:51:56 +01:00
flake.nix Make hatchling write us a _version.py when running the tests 2024-12-12 17:05:38 +00:00
Makefile correct notes 2022-10-02 14:53:03 -06:00
mypy.ini Merge remote-tracking branch 'origin/master' into clean-up-tor-and-i2p-providers 2023-04-05 08:37:58 -04:00
NEWS.rst missing summary 2024-12-14 02:13:08 -07:00
pyinstaller.spec remove old Python2 __future__ statements 2024-02-15 16:53:34 +01:00
pyproject.toml need tox for testing 2024-12-14 02:13:08 -07:00
pytest.ini clearer language in the slow mark documentation 2023-01-20 15:20:42 -05:00
README.rst Readme.md: Remove end year of copyright timespan 2024-12-19 20:19:14 +00:00
relnotes.txt update relnotes 2024-12-14 02:13:08 -07:00
Tahoe.home rename bin/allmydata-tahoe to bin/tahoe. Closes #155. 2007-10-11 03:38:24 -07:00
towncrier.toml fix the whitespace :/ 2021-10-18 08:11:49 -04:00
tox.ini tox changed their minds again 2024-12-14 02:13:08 -07:00
ws_client.py remove old Python2 __future__ statements 2024-02-15 16:53:34 +01:00

Free and Open Decentralized Data Store

image0

Tahoe-LAFS (Tahoe Least-Authority File Store) is the first free software / open-source storage technology that distributes your data across multiple servers. Even if some servers fail or are taken over by an attacker, the entire file store continues to function correctly, preserving your privacy and security.

code of conduct documentation status circleci githubactions code coverage

Table of contents

💡 About Tahoe-LAFS

Tahoe-LAFS helps you to store files while granting confidentiality, integrity, and availability of your data.

How does it work? You run a client program on your computer, which talks to one or more storage servers on other computers. When you tell your client to store a file, it will encrypt that file, encode it into multiple pieces, then spread those pieces out among various servers. The pieces are all encrypted and protected against modifications. Later, when you ask your client to retrieve the file, it will find the necessary pieces, make sure they havent been corrupted, reassemble them, and decrypt the result.

image2
The image is taken from meejah's blog post at Torproject.org.

The client creates pieces (“shares”) that have a configurable amount of redundancy, so even if some servers fail, you can still get your data back. Corrupt shares are detected and ignored so that the system can tolerate server-side hard-drive errors. All files are encrypted (with a unique key) before uploading, so even a malicious server operator cannot read your data. The only thing you ask of the servers is that they can (usually) provide the shares when you ask for them: you arent relying upon them for confidentiality, integrity, or absolute availability.

Tahoe-LAFS was first designed in 2007, following the "principle of least authority", a security best practice requiring system components to only have the privilege necessary to complete their intended function and not more.

Please read more about Tahoe-LAFS architecture here.

Installation

For more detailed instructions, read Installing Tahoe-LAFS.

Once tahoe --version works, see How to Run Tahoe-LAFS to learn how to set up your first Tahoe-LAFS node.

🐍 Python 2

Python 3.9 or later is required. If you are still using Python 2.7, use Tahoe-LAFS version 1.17.1.

🤖 Issues

Tahoe-LAFS uses the Trac instance to track issues. Please email jean-paul plus tahoe-lafs at leastauthority dot com for an account.

📑 Documentation

You can find the full Tahoe-LAFS documentation at our documentation site.

💬 Community

Get involved with the Tahoe-LAFS community:

🤗 Contributing

As a community-driven open source project, Tahoe-LAFS welcomes contributions of any form:

Before authoring or reviewing a patch, please familiarize yourself with the Coding Standard and the Contributor Code of Conduct.

🥳 First Contribution?

If you are committing to Tahoe for the very first time, it's required that you add your name to our contributor list in CREDITS. Please ensure that this addition has it's own commit within your first contribution.

🤝 Supporters

We would like to thank Fosshost for supporting us with hosting services. If your open source project needs help, you can apply for their support.

We are grateful to Oregon State University Open Source Lab for hosting tahoe-dev mailing list.

FAQ

Need more information? Please check our FAQ page.

📄 License

Copyright 2006- 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 choice, any later version. (You may choose to use this package under the terms of either license, 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.