@@ -109,6 +109,19 @@ running something on `8443`.
109109A complete walkthrough of the Urbit web interface is
110110[here](../web/).
111111
112+## Moons
113+
114+Urbit namespace is distributed by having parent nodes sign the keys for child nodes. If you have a planet, your parent star issued your ticket. As a planet you, in turn, can sign the keys for moons. The basic idea is: your planet runs permanently in a data center somewhere and moons run on all your devices. Each planet can issue ~4 billion (`2^32`) moons.
115+
116+To generate a random moon from your planet run:
117+
118+ ~your-urbit:dojo> +moon
119+
120+You can use the resulting output in the same installation flow from [install](/docs/using/install) and [setup](/docs/using/setup).
121+
122+Moons are automatically synced to their parent `%kids` desk, and can control applications on their parent planet using `|link`. You can read more about those things in the [filesystem](/docs/using/filesystem) and [console](/docs/using/shell) walkthroughs.
123+
124+
112125## Continuity breaches
113126
114127While the Urbit network is in this alpha state we sometimes have to