2011-11-18 00:15:11 +00:00
|
|
|
==========
|
2010-05-04 09:43:40 +00:00
|
|
|
Tahoe-LAFS
|
2011-11-18 00:15:11 +00:00
|
|
|
==========
|
2010-05-04 09:43:40 +00:00
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
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.
|
2010-05-04 09:43:40 +00:00
|
|
|
|
2016-03-30 08:11:51 +00:00
|
|
|
For full documentation, please see
|
2016-04-28 06:10:07 +00:00
|
|
|
http://tahoe-lafs.readthedocs.io/en/latest/ .
|
2016-03-30 08:11:51 +00:00
|
|
|
|
2016-10-08 20:09:14 +00:00
|
|
|
|readthedocs| |travis| |codecov|
|
2016-03-30 08:11:51 +00:00
|
|
|
|
2016-03-08 05:29:42 +00:00
|
|
|
INSTALLING
|
|
|
|
|
==========
|
|
|
|
|
|
|
|
|
|
Pre-packaged versions are available for several operating systems:
|
|
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
* Debian and Ubuntu users can ``apt-get install tahoe-lafs``
|
2016-03-08 05:29:42 +00:00
|
|
|
* NixOS, NetBSD (pkgsrc), ArchLinux, Slackware, and Gentoo have packages
|
|
|
|
|
available, see `OSPackages`_ for details
|
2016-03-16 19:50:48 +00:00
|
|
|
* `Mac`_ and Windows installers are in development.
|
2016-03-08 05:29:42 +00:00
|
|
|
|
|
|
|
|
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
|
2016-03-26 18:50:44 +00:00
|
|
|
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>`_.
|
2016-03-08 05:29:42 +00:00
|
|
|
|
|
|
|
|
Then, to install the most recent release, just run:
|
|
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
* ``pip install tahoe-lafs``
|
2016-03-08 05:29:42 +00:00
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
* ``git clone https://github.com/tahoe-lafs/tahoe-lafs.git``
|
|
|
|
|
* ``cd tahoe-lafs``
|
2017-04-06 10:08:18 +00:00
|
|
|
* ``virtualenv --python=python2.7 venv``
|
2017-04-12 20:53:55 +00:00
|
|
|
* ``venv/bin/pip install --upgrade setuptools``
|
2016-03-26 21:13:23 +00:00
|
|
|
* ``venv/bin/pip install --editable .``
|
|
|
|
|
* ``venv/bin/tahoe --version``
|
2016-03-08 05:29:42 +00:00
|
|
|
|
|
|
|
|
To run the unit test suite:
|
|
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
* ``tox``
|
2016-03-08 05:29:42 +00:00
|
|
|
|
2017-07-26 14:25:38 +00:00
|
|
|
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``
|
|
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
For more detailed instructions, read `<docs/INSTALL.rst>`_ .
|
2016-03-08 05:29:42 +00:00
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
Once ``tahoe --version`` works, see `<docs/running.rst>`_ to learn how to set
|
|
|
|
|
up your first Tahoe-LAFS node.
|
2010-05-04 09:43:40 +00:00
|
|
|
|
|
|
|
|
LICENCE
|
|
|
|
|
=======
|
|
|
|
|
|
2016-03-08 05:29:42 +00:00
|
|
|
Copyright 2006-2016 The Tahoe-LAFS Software Foundation
|
2012-03-13 20:50:57 +00:00
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
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.
|
2010-05-04 09:43:40 +00:00
|
|
|
|
2016-03-26 18:50:44 +00:00
|
|
|
See `TGPPL.PDF`_ for why the TGPPL exists, graphically illustrated on three
|
|
|
|
|
slides.
|
2010-05-04 09:43:40 +00:00
|
|
|
|
2016-03-08 05:29:42 +00:00
|
|
|
.. _OSPackages: https://tahoe-lafs.org/trac/tahoe-lafs/wiki/OSPackages
|
2016-03-16 19:50:48 +00:00
|
|
|
.. _Mac: docs/OS-X.rst
|
2016-03-08 05:29:42 +00:00
|
|
|
.. _pip: https://pip.pypa.io/en/stable/installing/
|
2013-04-02 17:46:52 +00:00
|
|
|
.. _COPYING.GPL: https://github.com/tahoe-lafs/tahoe-lafs/blob/master/COPYING.GPL
|
2016-03-26 18:50:44 +00:00
|
|
|
.. _COPYING.TGPPL: https://github.com/tahoe-lafs/tahoe-lafs/blob/master/COPYING.TGPPL.rst
|
2011-10-29 19:42:40 +00:00
|
|
|
.. _TGPPL.PDF: https://tahoe-lafs.org/~zooko/tgppl.pdf
|
2014-09-09 17:51:44 +00:00
|
|
|
|
|
|
|
|
----
|
|
|
|
|
|
2016-03-30 08:32:57 +00:00
|
|
|
.. |readthedocs| image:: http://readthedocs.org/projects/tahoe-lafs/badge/?version=latest
|
2016-03-30 08:35:27 +00:00
|
|
|
:alt: documentation status
|
2016-04-28 06:10:07 +00:00
|
|
|
:target: http://tahoe-lafs.readthedocs.io/en/latest/?badge=latest
|
2016-03-30 08:32:57 +00:00
|
|
|
|
|
|
|
|
.. |travis| image:: https://travis-ci.org/tahoe-lafs/tahoe-lafs.png?branch=master
|
2016-03-30 08:35:27 +00:00
|
|
|
:alt: build status
|
|
|
|
|
:target: https://travis-ci.org/tahoe-lafs/tahoe-lafs
|
2014-09-09 17:51:44 +00:00
|
|
|
|
2016-10-08 20:09:14 +00:00
|
|
|
.. |codecov| image:: https://codecov.io/github/tahoe-lafs/tahoe-lafs/coverage.svg?branch=master
|
2016-03-30 08:35:27 +00:00
|
|
|
:alt: test coverage percentage
|
2016-10-08 20:09:14 +00:00
|
|
|
:target: https://codecov.io/github/tahoe-lafs/tahoe-lafs?branch=master
|
