This is how to use your Tahoe node. First, you have to run your own local Tahoe node, as described in running.html.

The WUI

Point your web browser to http://127.0.0.1:3456 -- which is the URL of your own local computer -- to use your newly created node.

Create a new directory (with the button labelled "create a directory"). Your web browser will load the new directory. Now if you want to be able to come back to this directory later, you have to bookmark it, or otherwise save the URL of it. If you lose URL to this directory, then you can never again come back to this directory.

You can do more or less everything you want to do with a decentralized filesystem through the WUI.

P.S. "WUI" is pronounced "wooey".

The CLI

Prefer the command-line? Run "tahoe --help" (the same command-line tool that is used to start and stop nodes serves to navigate and use the decentralized filesystem). To get started, create a new directory and mark it as the 'tahoe:' alias by running "tahoe add-alias tahoe `tahoe mkdir`". Once you've done that, you can do "tahoe ls tahoe:" and "tahoe cp LOCALFILE tahoe:foo.txt" to work with your filesystem. The Tahoe CLI uses the same syntax as the well-known scp and rsync tools. See CLI.txt for more details.

As with the WUI (and with all current interfaces to Tahoe), you are responsible for remembering directory capabilities yourself. If you create a new directory and lose the capability to it, then you cannot access that directory ever again.

P.S. "CLI" is pronounced "clee".

The FUSE Extension

You can plug Tahoe into your computer's local filesystem using the FUSE extension, found in the contrib directory. Warning: unlike most of Tahoe, and unlike the rest of the user interfaces described on this page, the FUSE plugin doesn't have extensive unit tests that are automatically run on every check-in of the source. Therefore, we can't be sure how complete and reliable it is.

P.S. "FUSE" rhymes with "muse".

The WAPI

Want to program your Tahoe node to do your bidding? Easy! See webapi.txt.

P.S. "WAPI" is pronounced "wappy".

Socialize

You can chat with other users of and hackers of this software at http://allmydata.org.