git.iko.soy/urbit.org
on master help sign in
Migrating development information into /develop
579f18dMatilde Park
content/develop.md+98−2
compare with master
unifiedsplit
@@ -5,8 +5,104 @@ template = "page_indiced.html"
5
5
6## Creating a Development Ship {#creating-a-development-ship}
6## Creating a Development Ship {#creating-a-development-ship}
7
7
8−[From the docs.]
8+To do work with Hoon and with the system, we recommended using a "fake" ship -- one not connected to the network.
9+
10+Because such a ship has no presence on the network, you don't need an Azimuth identity for its purposes. You just need to have [installed our software](@/docs/getting-started/installing-urbit.md).
11+
12+To create a fake ship named `~zod`, run the command below. You can replace `zod` with any valid Urbit ship-name.
13+
14+```
15+urbit -F zod
16+```
17+
18+Now you should see a block of boot messages, starting with the Urbit version number. Welcome!
19+
20+### Basic Operations
21+
22+Welcome to your ship! There's a few things you should do to become oriented.
23+
24+#### The Dojo
25+
26+Let's try out the Dojo, the Arvo command line and Hoon REPL:
27+
28+```
29+~sample-planet:dojo> (add 2 2)
30+```
31+
32+Should produce:
33+
34+```
35+> (add 2 2)
36+4
37+```
38+
39+Good.
40+
41+#### Mounting
42+
43+Your ship's filesystem being "mounted" means that its filesystem can be interacted with through Unix. This makes things much easier for you.
44+
45+The Arvo filesystem isn't mounted to Unix by default. Switch to the Dojo prompt and run:
46+
47+```
48+~sample-planet:dojo> |mount %
49+```
50+
51+This should produce:
52+
53+```
54+> |mount %
55+>=
56+```
57+
58+which indicates that the command was processed.
59+
60+`|mount %` will cause a `home/` directory to appear inside your _pier_ folder in Unix (the "pier" is our shorthand for the directory whose name corresponds to your Azimuth point). Changes to these files can be committed to your pier by running `|commit %home` once you're done.
61+
62+#### Shutting Down and Restarting
63+
64+You can turn your ship off with `ctrl-d` from the Talk or Dojo prompts.
65+
66+To restart your ship, simply pass the name of your pier:
67+
68+```
69+urbit some-planet
70+```
71+
72+## Creating a Comet Ship {#creating-a-comet}
73+
74+**Comets** are urbits whose names are 128-bits or 16 syllables, such as:
75+
76+`~dasres-ragnep-lislyt-ribpyl--mosnyx-bisdem-nidful-marzod`
77+
78+Comet names aren't quite as memorable as others, but they're disposable identities that anyone can make for free to join the live network.
79+
80+### Booting a Comet
81+
82+To boot your comet, go into the command line and run the following command from the directory that was created during Urbit installation:
83+
84+```
85+$ urbit -c mycomet
86+```
87+
88+This will take a few minutes and will spin out a bunch of boot messages. Toward the end, you'll see something like:
89+
90+```
91+ames: on localhost, UDP 31337.
92+http: live (insecure, public) on 8080
93+http: live ("secure", public) on 8443
94+http: live (insecure, loopback) on 12321
95+~dasres_marzod:dojo>
96+```
9
97
10## Community Tutorials {#community-tutorials}
98## Community Tutorials {#community-tutorials}
11
99
12−[From the docs.]
100+Here are some tutorials written by members of the Urbit community. Some are a little outdated, but they may still prove useful.
101+
102+- [Generators](https://github.com/joemfb/mardev/tree/master/docs/gen) by `~master-morzod`
103+- [Urbit by Doing](https://github.com/Fang-/Urbit-By-Doing) by `~palfun-foslup`
104+- [Learning Hoon](https://github.com/knubie/learning-hoon) by `@knubie`
105+- [A Nock Interpreter](https://jtobin.io/nock) by `~nidsut-tomdun`
106+- [Basic Hoonery](https://jtobin.io/basic-hoonery) by `~nidsut-tomdun`
107+
108+If you want to add something to the list, [shoot us an email](mailto:support@urbit.org) or make a pull request in the [docs repository](https://github.com/urbit/docs).