mirror of
https://github.com/tahoe-lafs/tahoe-lafs.git
synced 2025-01-03 19:54:09 +00:00
82579cec96
Add ".. -*- coding: utf-8-with-signature -*-" to the first line of each .rst file. This tells emacs to treat the file contents as utf-8, and also to prepend a so-called utf-8 "bom" marker at the beginning of the file. This patch also prepends those markers to each of those files.
77 lines
2.7 KiB
ReStructuredText
77 lines
2.7 KiB
ReStructuredText
.. -*- coding: utf-8-with-signature -*-
|
|
|
|
==================
|
|
Getting Tahoe-LAFS
|
|
==================
|
|
|
|
Welcome to `the Tahoe-LAFS project`_, a secure, decentralized, fault-tolerant
|
|
storage system.
|
|
|
|
`about Tahoe-LAFS <about.rst>`__
|
|
|
|
.. _the Tahoe-LAFS project: https://tahoe-lafs.org
|
|
|
|
How To Get Tahoe-LAFS
|
|
=====================
|
|
|
|
This procedure has been verified to work on Windows, Mac, OpenSolaris, and
|
|
too many flavors of Linux and of BSD to list. It's likely to work on other
|
|
platforms.
|
|
|
|
In Case Of Trouble
|
|
------------------
|
|
|
|
There are a few 3rd party libraries that Tahoe-LAFS depends on that might not
|
|
be easy to set up on your platform. If the following instructions don't Just
|
|
Work without any further effort on your part, then please write to `the
|
|
tahoe-dev mailing list`_ where friendly hackers will help you out.
|
|
|
|
.. _the tahoe-dev mailing list: https://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev
|
|
|
|
Install Python
|
|
--------------
|
|
|
|
Check if you already have an adequate version of Python installed by running
|
|
``python -V``. Python v2.6 (v2.6.6 or greater recommended) or Python v2.7 will
|
|
work. Python v3 does not work. On Windows, we recommend the use of native
|
|
Python v2.7, not Cygwin Python. If you don't have one of these versions of
|
|
Python installed, download and install `Python v2.7`_. Make sure that the path
|
|
to the installation directory has no spaces in it (e.g. on Windows, do not
|
|
install Python in the "Program Files" directory).
|
|
|
|
.. _Python v2.7: http://www.python.org/download/releases/2.7.4/
|
|
|
|
Get Tahoe-LAFS
|
|
--------------
|
|
|
|
Download the latest stable release, `Tahoe-LAFS v1.10.0`_.
|
|
|
|
.. _Tahoe-LAFS v1.10.0: https://tahoe-lafs.org/source/tahoe-lafs/releases/allmydata-tahoe-1.10.0.zip
|
|
|
|
Set Up Tahoe-LAFS
|
|
-----------------
|
|
|
|
Unpack the zip file and cd into the top-level directory.
|
|
|
|
Run "``python setup.py build``" to generate the ``tahoe`` executable in a
|
|
subdirectory of the current directory named ``bin``. This will download and
|
|
build anything you need from various websites.
|
|
|
|
On Windows, the ``build`` step might tell you to open a new Command Prompt
|
|
(or, on XP and earlier, to log out and back in again). This is needed the
|
|
first time you set up Tahoe-LAFS on a particular installation of Windows.
|
|
|
|
Run "``bin/tahoe --version``" (on Windows, "``bin\tahoe --version``") to verify
|
|
that the executable tool prints out the right version number after
|
|
"``allmydata-tahoe:``".
|
|
|
|
Optionally run "``python setup.py trial``" to verify that it passes all of its
|
|
self-tests.
|
|
|
|
Run Tahoe-LAFS
|
|
--------------
|
|
|
|
Now you are ready to deploy a decentralized filesystem. The ``tahoe``
|
|
executable in the ``bin`` directory can configure and launch your Tahoe-LAFS
|
|
nodes. See `<running.rst>`__ for instructions on how to do that.
|