= Documentation for Tahoe-LAFS Users =

There are two collections of documents for users. One collection is made up of pages on this wiki, and the other is made up of files in the 'docs' directory of the Tahoe-LAFS source tree.

Note: these links are to the 'trunk' (latest) versions of the documentation. See the 'docs' directory of a Tahoe-LAFS release for docs relating to that version.

== First Steps ==

 * [source:docs/about.rst about]: the Tahoe-LAFS filesystem and the unique properties that it offers
 * [source:docs/quickstart.rst quickstart]: how to get the software and set it up
 * [source:docs/running.rst running]: how to run it once it is set up

== User Docs, on the wiki ==

 * [wiki:TestGrid Public Test Grid]: an existing grid to use for testing your installation

 * [wiki:HowToReportABug How To Report A Bug]: We love bug reports! Here's how.

 * [http://bigasterisk.com/tahoe-playground The story of a file], interactive illustration by Drew Perttula.

 * [wiki:FAQ Frequently Asked Questions]: with answers!

 * [wiki:UseCases UseCases]: the ways in which Tahoe-LAFS should be useful
 * [wiki:SftpFrontend SFTP Frontend]: compatibility issues for accessing Tahoe-LAFS via SFTP
 * [wiki:TipsTricks Tips & Tricks]

 * [wiki:Capabilities] what are capabilities; the different kinds that we currently use

== User Docs, in source code ==
 * [source:docs/ the 'docs' directory]

 * [source:docs/configuration.rst configuration]: a description of the contents of your ".tahoe" directory
 * [source:docs/architecture.rst architecture]: a succinct overview of the whole system
 * [source:docs/frontends/CLI.rst Command Line Interface]: the basic "how to" for the CLI
 * [source:docs/frontends/webapi.rst Web API]: the basic "how to" for the WAPI

 * [source:docs/known_issues.rst Known Issues]: things you need to be aware of if you want to rely on Tahoe-LAFS to store your valuable data.

== Developer Docs ==

 * [wiki:Dev#DeveloperDocs Developer Docs]

== See Also ==
 * [wiki:RelatedProjects The RelatedProjects page] extensions to Tahoe-LAFS, integrations of Tahoe-LAFS into your favorite other tools, and links to a few other decentralized storage projects that you might be interested in.
 * [wiki:News The News page] has sources of news and information.

== The Parade of Release Notes ==

||=NEWS=||=date=||=what's new=||
|| [source:/trunk/NEWS.rst@befa4ba 1.10.2] || 30-Jul-2015 || a few bugfixes, build/packaging fixes, fewer warnings from build ||
|| [source:/trunk/NEWS.rst@588702 1.10.1] || 16-Jun-2015 || many bugfixes, cp -r ||
|| [source:/trunk/NEWS.rst@f9af063 1.10.0] || 01-May-2013 || signed Introducer, unguessable introducer.furl, new Welcome page ||
|| [source:/trunk/NEWS.rst@0556a98 1.9.2] || 03-Jul-2012 || fix regressions in mutable file handling ||
|| [source:/trunk/NEWS.rst@d9c7dfa 1.9.1] || 12-Jan-2012 || critical security fix ||
|| [source:/trunk/NEWS.rst@ac49656 1.9.0] || 31-Oct-2011 || new mutable-file format (more efficient for large files), file-blacklisting, drop-upload ||
|| [source:/1.8.3/NEWS@13d284b 1.8.3] || 13-Sep-2011 || security fix ||
|| [source:/trunk/NEWS@7a4f76f 1.8.2] || 30-Jan-2011 || Twisted-10.2 compatibility, minor bugfixes ||
|| [source:/trunk/NEWS@ce41eab 1.8.1] || 28-Nov-2010 || minor bugfixes, including a security fix and a performance improvement to downloads; also binary packages of dependencies for more platforms ||
|| [source:/trunk/NEWS@6bf594a 1.8.0] || 24-Sep-2010 || performance and fault-tolerance of downloads, internationalization on Windows, logging, packaging ||
|| [source:/trunk/NEWS@9f3995f 1.7.1] || 19-Jul-2010 || upload bugfixes, Debian init scripts, etc. ||
|| [source:/trunk/NEWS@7fde9d7 1.7.0] || 18-Jun-2010 || SFTP, unicode, servers-of-happiness ||
|| [source:/trunk/NEWS@b7c0248 1.6.1] || 27-Feb-2010 || fixes a few small regressions in 1.6.0 ||
|| [source:/trunk/NEWS@80816fd 1.6]   || 01-Feb-2010 || performance improvements, usability improvements, deep-immutable directories ||
|| [source:/trunk/NEWS@263713e 1.5]   || 01-Aug-2009 || WUI style, forward-compatibility, no size-limit on directories, more efficient directories, safer mv ||
|| [source:/trunk/NEWS@8c687c7 1.4.1] || 13-Apr-2009 || garbage collection, improved diagnostics, performance improvement when downloading many GB files ||
|| [source:/trunk/NEWS@967d1b4 1.3]   || 13-Feb-2009 || repairer, backup command, large files, (S)FTP server, more ||
|| [source:/trunk/NEWS@1d68f87 1.2]   || 21-Jul-2008 || fix a minor security flaw, add operational improvements ||
|| [source:/trunk/NEWS@4c71ffb 1.1]   || 11-Jun-2008 || fix rare but serious issues, improve UI ||
|| [source:/trunk/relnotes.txt@ef15167 1.0]   || 25-Mar-2008 || It's version 1.0! ||
|| [source:/trunk/relnotes.txt@229142e 0.9]   || 13-Mar-2008 || Tahoe is now ready to be relied on for secure storage ||
|| [source:/trunk/relnotes.txt@098b593 0.8]   || 15-Feb-2008 || "visibility" into the system and more user interfaces ||
|| [source:/trunk/relnotes.txt@9033d88 0.7]   || 08-Jan-2008 || decentralized directories and mutable files, a FUSE interface, and new open source licensing options ||
|| [source:/trunk/relnotes.txt@1c1d96b 0.6.1] || 15-Oct-2007 || packaging, usability, and performance improvements ||
|| [source:/trunk/relnotes.txt@db09057 0.6]   || 24-Sep-2007 || improved performance and packaging ||
|| [source:/trunk/relnotes.txt@44db5fd 0.5.1] || 23-Aug-2007 || fix a security problem in the Web API ||
|| [source:/trunk/relnotes.txt@3e1c417 0.5]   || 17-Aug-2007 || the Web API and the command-line interface ||
|| [source:/trunk/relnotes.txt@e72bff1 0.4]   || 29-Jun-2007 || new mutable, shareable, private directories ||
|| [source:/trunk/relnotes.txt@c8077de 0.3]   || 06-Jun-2007 || improved basic functionality ||
|| [source:/trunk/relnotes.txt@d09eadd 0.2]   || 02-May-2007 || the first public release, on May 2, 2007 and giving a general overview of why the Tahoe project exists ||