2008-01-02 00:20:07 +00:00
|
|
|
<!DOCtype HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
|
|
<html lang="en">
|
|
|
|
<head>
|
|
|
|
<title>Running Tahoe</title>
|
|
|
|
<link rev="made" class="mailto" href="mailto:zooko[at]zooko[dot]com">
|
|
|
|
<meta name="description" content="how to run Tahoe">
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
2008-01-04 04:11:59 +00:00
|
|
|
<meta name="keywords" content="tahoe secure decentralized filesystem operation">
|
2008-01-02 00:20:07 +00:00
|
|
|
</head>
|
|
|
|
|
|
|
|
<body>
|
2008-01-08 17:32:41 +00:00
|
|
|
<h1>How To Start Tahoe</h1>
|
2008-01-02 00:20:07 +00:00
|
|
|
|
2008-01-02 04:50:46 +00:00
|
|
|
<p>This is how to run a Tahoe node or a complete Tahoe grid. First you
|
|
|
|
have to install the Tahoe source code, as documented in <a
|
|
|
|
href="install.html">install.html</a>.</p>
|
|
|
|
|
|
|
|
<p>The <cite>tahoe</cite> executable is used to create, start, and stop
|
|
|
|
nodes. Each node lives in a separate base directory, inside of which you
|
|
|
|
can add files to configure the node. Nodes also read and write files
|
|
|
|
within that directory.</p>
|
|
|
|
|
|
|
|
<p>A grid consists of a single Introducer and one or more nodes. If you
|
|
|
|
are creating a new grid, you'll need to create both an Introducer and a
|
|
|
|
node (and then invite other people to create their own nodes and join
|
|
|
|
your grid). If you are joining an existing grid (such as <a
|
|
|
|
href="http://allmydata.org/trac/tahoe/wiki/TestGrid">the public test
|
|
|
|
grid</a>), the Introducer will already be running, and you'll need to
|
|
|
|
create a node.</p>
|
|
|
|
|
2008-01-06 08:16:57 +00:00
|
|
|
<p>To construct a node run <cite>tahoe create-client</cite>, which will
|
|
|
|
create <cite>~/.tahoe</cite> to be the node's base directory. Acquire a copy
|
|
|
|
of the <cite>introducer.furl</cite> from the introducer and put it into this
|
|
|
|
directory, then run <cite>tahoe start</cite>. After that, the node should be
|
|
|
|
off and running. The first thing it will do is connect to the introducer and
|
|
|
|
get itself connected to all other nodes on the grid.</p>
|
|
|
|
|
2008-01-04 04:11:59 +00:00
|
|
|
<p>To construct an introducer, create a new base directory for it (the name
|
|
|
|
of the directory is up to you), cd into it, and run <cite>tahoe
|
|
|
|
create-introducer .</cite>. Now start the introducer by running <cite>tahoe
|
|
|
|
start .</cite>. After it starts, there will be a file named
|
2008-01-02 04:50:46 +00:00
|
|
|
<cite>introducer.furl</cite> in that base directory. This file contains
|
|
|
|
the URL which the nodes must use in order to connect to this
|
|
|
|
introducer.</p>
|
|
|
|
|
2008-01-08 17:32:41 +00:00
|
|
|
<h2>Run</h2>
|
|
|
|
|
|
|
|
<p>Now you have a decentralized filesystem. See <a href="using.html">using.html</a> for instructions about how to interact with it.</p>
|
2008-01-02 04:50:46 +00:00
|
|
|
|
|
|
|
</body>
|
|
|
|
|
|
|
|
</html>
|