mirror of
https://github.com/tahoe-lafs/tahoe-lafs.git
synced 2024-12-20 21:43:09 +00:00
113 lines
3.9 KiB
ReStructuredText
113 lines
3.9 KiB
ReStructuredText
==========
|
|
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/ .
|
|
|
|
|Contributor Covenant| |readthedocs| |travis| |circleci| |codecov|
|
|
|
|
|
|
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.
|
|
|
|
.. _OSPackages: https://tahoe-lafs.org/trac/tahoe-lafs/wiki/OSPackages
|
|
.. _Mac: docs/OS-X.rst
|
|
.. _pip: https://pip.pypa.io/en/stable/installing/
|
|
.. _COPYING.GPL: https://github.com/tahoe-lafs/tahoe-lafs/blob/master/COPYING.GPL
|
|
.. _COPYING.TGPPL: https://github.com/tahoe-lafs/tahoe-lafs/blob/master/COPYING.TGPPL.rst
|
|
.. _TGPPL.PDF: https://tahoe-lafs.org/~zooko/tgppl.pdf
|
|
|
|
----
|
|
|
|
.. |readthedocs| image:: http://readthedocs.org/projects/tahoe-lafs/badge/?version=latest
|
|
:alt: documentation status
|
|
:target: http://tahoe-lafs.readthedocs.io/en/latest/?badge=latest
|
|
|
|
.. |travis| image:: https://travis-ci.org/tahoe-lafs/tahoe-lafs.png?branch=master
|
|
:alt: build status
|
|
:target: https://travis-ci.org/tahoe-lafs/tahoe-lafs
|
|
|
|
.. |circleci| image:: https://circleci.com/gh/tahoe-lafs/tahoe-lafs.svg?style=svg
|
|
:target: https://circleci.com/gh/tahoe-lafs/tahoe-lafs
|
|
|
|
.. |codecov| image:: https://codecov.io/github/tahoe-lafs/tahoe-lafs/coverage.svg?branch=master
|
|
:alt: test coverage percentage
|
|
:target: https://codecov.io/github/tahoe-lafs/tahoe-lafs?branch=master
|
|
|
|
.. |Contributor Covenant| image:: https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg
|
|
:alt: code of conduct
|
|
:target: docs/CODE_OF_CONDUCT.md
|