@@ -7,35 +7,38 @@ title: Setup
8# Getting started
8# Getting started
11−<div class="col-md-8">
13−On disk your Urbit is an append-only log and a checkpoint. Or, in simpler terms, a directory where we keep all of your Urbit’s state. We call this a ‘pier’.
10+On disk your urbit is an append-only log and a checkpoint. Or, in simpler terms, a directory where we keep your urbit’s state. We call this a ‘pier’.
18## Initialize
12## Initialize
20−When you first start an Urbit we create this pier directory and write to it.
14+To create an urbit, we need an identity, called a "ship." A ship
15+is both a network address and a memorable name.
17+You are probably creating one of two kinds of ship, a 32-bit
18+"planet" or a 128-bit "comet."
20+If you have an Urbit invitation, you'll have a planet like
22−To start with a planet (`~fintud-macrep`) and ticket (`~fortyv-tombyt-tabsen-sonres`):
21+`~fintud-macrep` and `~fortyv-tombyt-tabsen-sonres`. To create
24− bin/urbit -w fintud-macrep -t fortyv-tombyt-tabsen-sonres
24+ $ bin/urbit -w fintud-macrep -t fortyv-tombyt-tabsen-sonres
26−This will create a directory `fintud-macrep/` and begin the initialization process for that planet. Be patient, it can take a few minutes.
26+This will create a directory `fintud-macrep/` and begin building
27+your urbit. This may take a few minutes.
28−Without a planet anyone can create a comet:
29+If you do not have a ticket, you can still make a 'comet', a wild
30+urbit drifting through cyberspace. Pick your own directory name,
30− bin/urbit -c comet
33+ $ bin/urbit -c mycomet
32−This will create a directory `comet/` and start up a random 64-bit comet. You can specify any name you like.
35+This will create the directory `mycomet/` and generate a 128-bit identity for your urbit.
34## Orientation
37## Orientation
36−When your Urbit is finished booting you should see a `dojo>` prompt. Welcome!
39+When your urbit is finished booting you should see a `dojo>` prompt. Welcome!
38−By default your Urbit is quite bare bones. Let's take a very short stroll through what's running by default:
41+By default your urbit is quite bare-bones. Let's stroll through what's already running:
40### Shell — `:dojo`
43### Shell — `:dojo`
@@ -52,11 +55,13 @@ Good.
53### Messaging — `:talk`
56### Messaging — `:talk`
55−Use `^X` to change your prompt. Let's join the main Urbit chat channel:
58+Use `^X` (ctrl-x) to change your prompt. Let's join the main Urbit chat channel:
57 ~fitund-macrep:talk() ;join ~doznec/urbit-meta
60 ~fitund-macrep:talk() ;join ~doznec/urbit-meta
62+`:talk` is stateful, so your urbit will download a backlog.
59−This may take a bit as `:talk` is stateful so your Urbit will download some backlog. `/urbit-meta` is the place to ask questions, get help and talk about anything Urbit related.
63+`/urbit-meta` is the place to ask questions, get help and talk
64+about anything Urbit-related.
61### Web — `:tree`
66### Web — `:tree`
@@ -64,7 +69,11 @@ Urbit is also accessible through the web. Try opening:
65 http://localhost:8080/
70 http://localhost:8080/
72+in your favorite browser. You'll be prompted to use `+code`.
73+This page was generated by `:tree`, the basic Urbit web
74+interface. You can also access your urbit through
67−in your favorite browser. You'll be prompted to use `+code`. This page was generated by `:tree`, the basic Urbit web interface. You can also access your Urbit through `http://fintud-macrep.urbit.org` (where `fintud-macrep` is your planet name).
75+`http://fintud-macrep.urbit.org` (where `fintud-macrep` is your
69### Filesystem — `%clay`
78### Filesystem — `%clay`
@@ -79,7 +88,7 @@ This should produce:
80which indicates the command was processed.
89which indicates the command was processed.
82−`|mount %` will cause a `home/` directory to appear inside your pier folder. Changes to these files are automatically synced into your Urbit.
91+`|mount %` will cause a `home/` directory to appear inside your pier folder. Changes to these files are automatically synced into your urbit.
84## Learn more
93## Learn more