@@ -0,0 +1,92 @@
1+---
2+next: true
3+sort: 3
4+title: Getting started
5+---
6+
7+# Getting started
8+
9+<div class="row"><div class="col-md-8">
10+
11+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’.
12+
13+</div></div>
14+
15+## Initialize
16+
17+When you first start an Urbit we create this pier directory and write to it.
18+
19+To start with a planet (`~fintud-macrep`) and ticket (`~fortyv-tombyt-tabsen-sonres`):
20+
21+ bin/urbit -w fintud-macrep -t fortyv-tombyt-tabsen-sonres
22+
23+This will create a directory `fintud-macrep/` and begin the initialization process for that planet. Be patient, it can take a few minutes.
24+
25+Without a planet anyone can create a comet:
26+
27+ bin/urbit -c comet
28+
29+This will create a directory `any-name/` and start up a random 64-bit comet.
30+
31+## Orientation
32+
33+When your Urbit is finished booting you should see a `dojo>` prompt. Welcome!
34+
35+By default your Urbit is quite bare bones. Let's take a very short stroll through what's running by default:
36+
37+### `:dojo`
38+
39+The command prompt in front of you is a simple shell and Hoon REPL. Let's make sure it works:
40+
41+ ~fitund-macrep:dojo> (add 2 2)
42+
43+Should produce:
44+
45+ > (add 2 2)
46+ 4
47+
48+Good.
49+
50+### `:talk`
51+
52+Use `^X` to change your prompt. Let's join the main Urbit chat channel:
53+
54+ ~fitund-macrep:talk() ;join ~doznec/urbit-meta
55+
56+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.
57+
58+### `:tree`
59+
60+Urbit is also accessible through the web. Try opening:
61+
62+ http://localhost:8080/
63+
64+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).
65+
66+### `%clay`
67+
68+`%clay`, the Urbit filesystem, isn't mounted to unix by default. Switch to the `:dojo` prompt and run:
69+
70+ ~fitund-macrep:dojo> |mount %
71+
72+This should produce:
73+
74+ > |mount %
75+ >=
76+
77+which indicates the command was processed.
78+
79+`|mount %` will cause a `home/` directory to appear inside your pier folder. Changes to these files are automatically synced into your Urbit.
80+
81+## Learn more
82+
83+We go into much greater detail about each of these components in our walkthroughs:
84+
85+#### [`:dojo`]()
86+#### [`:talk`]()
87+#### [`:tree`]()
88+#### [`%clay`]()
89+#### [`Administration`]()
90+#### [`Source guide`]()
91+
92+If you're eager to simply start programming, skip to [the Hoon tutorial]()