@@ -139,15 +139,52 @@ planet can issue ~4 billion (`2^32`) moons.
139To generate a random moon from your planet, run:
139To generate a random moon from your planet, run:
142−~your-urbit:dojo> +moon
142+~sampel-palnet:dojo> +moon
143+moon: ~faswep-navred-sampel-palnet
144+\/~.0wd.rZU67.3jSny.z1vda.7sr-s.EL1Jt.-76Nj.ugXxY.g6-Bx.HvKZl.G53oV.hPnXe.7U3E3.J4CEe.MEVuq.~08Nt\/
145+ .zNT0K.k-Ab~.Nn90d.OZ2fT.-XlQQ.Cfrkf.y6~K0.2Do09.EaE3W.BSK--.5Q~9N.y3QIP.eokH-.T6lwz.gg8MX.7LU5
146+ x.DJROE.IzQsy.OXOLr.IOE3a.-QI40.H5ukK.Cw-u4.uxE-y.V-o1F.Q84g0.effP0.de01g.600g1
150+You must manually edit the output of `+moon` to get
151+the correct format for the `<key>`:
155+- combine into one line, omitting spaces
157+- trim the leading `~.`
159+`<key>` would be `0wd.rZU67.3jSny.z1vda ... <snip> ... effP0.de01g.600g1`
162+Put `<key>` in a file and that file becomes `<keyfile>`.
164+*`<keyfile>` must not have a trailing newline.*
166+Another way of generating `<keyfile>` is:
169+~sampel-palnet:dojo> @moon/key +moon
170+moon: ~faswep-navred-sampel-palnet
173+`<keyfile>` will be at `path/to/sampel-palnet/.urb/put/moon.key`
174+and does not need editing to be used with the `-k` option.
145You can use the resulting output in the same installation flow from
176You can use the resulting output in the same installation flow from
146[install](../install) and [setup](../setup), following the same scheme as
177[install](../install) and [setup](../setup), following the same scheme as
147for booting a planet. That scheme is:
178for booting a planet. That scheme is:
150−$ urbit -w <moonname> -t <ticket> -c <piername>
181+$ urbit -w <moonname> -G <key> -c <piername>
187+$ urbit -w <moonname> -k <keyfile> -c <piername>
153The `-c <piername>` argument is not required, but it is recommended; otherwise,
190The `-c <piername>` argument is not required, but it is recommended; otherwise,
@@ -156,9 +193,14 @@ the resulting directory is a rather unwieldy moon name.
156Here's how an example moon might be booted:
193Here's how an example moon might be booted:
159−$ urbit -w faswep-navred-sampel-palnet -t habref-mebsem-parsym-batlus -c mymoon
196+$ urbit -w faswep-navred-sampel-palnet -G <key> -c mymoon
202+$ urbit -w faswep-navred-sampel-palnet -k <keyfile> -c mymoon
163Moons are automatically synced to their parent `%kids` desk, and can control
205Moons are automatically synced to their parent `%kids` desk, and can control
164applications on their parent planet using `|link`. You can read more about
206applications on their parent planet using `|link`. You can read more about