@@ -2,96 +2,123 @@
22navhome: /docs/
33navuptwo: true
44next: true
5−sort: 4
5+sort: 3
66title: Administration and operation
77---
88
99# Administration and operation
1010
11−<div class="row">
12−<div class="col-md-8">
13−
14−Your Urbit is a persistent Unix process that you mainly control from the console. For some things, a browser will also work.
15−
16−</div>
17−</div>
11+Your Urbit is a persistent Unix process that you mainly control from the
12+console. For some things, a browser will also work.
1813
1914## Shutdown
2015
21−You can turn your Urbit off with `ctrl-d` from the Talk or Dojo prompts.
16+You can turn your Urbit off with `Ctrl-d` from the Talk or Dojo prompts.
2217
2318## Restart
2419
2520To restart your Urbit simply pass the name of your pier:
2621
27− $ urbit some-planet
22+```
23+$ urbit some-planet
24+```
2825
2926or
3027
31− $ urbit comet
32−
28+```
29+$ urbit comet
30+```
3331
3432## Logging
3533
3634To log Urbit's command line output to a file, use `script`:
3735
38− $ script urbit.log urbit your-urbit
36+```
37+$ script urbit.log urbit your-urbit
38+```
3939
4040## Moving your pier
4141
42−Piers are designed to be portable, but it *must* be done while the Urbit is turned off. Urbit networking is stateful, so you can't run two copies of the same Urbit in two places.
43−
44−To move a pier, simply move the contents of the directory it lives in. To keep these files as small as possible we usually use the `--sparse` option in `tar`. With a pier `your-urbit/` something like this (from inside `urbit/`) should work:
42+Piers are designed to be portable, but it _must_ be done while the Urbit
43+is turned off. Urbit networking is stateful, so you can't run two copies
44+of the same Urbit in two places.
4545
46− tar -Scvzf your-urbit.tar.gz ./your-urbit/
46+To move a pier, simply move the contents of the directory it lives in.
47+To keep these files as small as possible we usually use the `--sparse`
48+option in `tar`. With a pier `your-urbit/` something like this (from
49+inside `urbit/`) should work:
4750
48−# Operation
51+```
52+tar -Scvzf your-urbit.tar.gz ./your-urbit/
53+```
4954
5055## Console
5156
52−Your Urbit terminal is separated into two parts: the prompt (the bottom line) and the record (everything above that). The record is shared; all the output from all the apps in your command set appears in it. The prompt is multiplexed.
57+Your Urbit terminal is separated into two parts: the prompt (the bottom
58+line) and the record (everything above that). The record is shared; all
59+the output from all the apps in your command set appears in it. The
60+prompt is multiplexed.
5361
54−In the CLI Urbit apps can process your input before you hit return. To see this in action try entering `)` as the first character at the Dojo prompt. Since there is no dojo command or hoon expression that starts with ')', the dojo rejects it.
62+In the CLI Urbit apps can process your input before you hit return. To
63+see this in action try entering `)` as the first character at the Dojo
64+prompt. Since there is no Dojo command or Hoon expression that starts
65+with ')', the Dojo rejects it.
5566
56−`ctrl-x` - Switches the prompt between running console apps
67+`Ctrl-x` - Switches the prompt between running console apps
5768
58−`ctrl-c` - Crash current event. Processed at the Unix layer and prints a stack trace.
69+`Ctrl-c` - Crash current event. Processed at the Unix layer and prints a stack trace.
5970
60−`ctrl-d` - From Talk or Dojo stops your Urbit process.
71+`Ctrl-d` - From Talk or Dojo stops your Urbit process.
6172
6273`↑` / `↓` - History navigation
6374
6475The following emacs-style key bindings are available:
6576
66− ctrl-a cursor to beginning of the line (Home)
67− ctrl-b cursor one character backward (left-arrow)
68− ctrl-e cursor to the end of the line (End)
69− ctrl-f cursor one character forward (right-arrow)
70− ctrl-g beep; cancel reverse-search
71− ctrl-k kill to end of line
72− ctrl-l clear the screen
73− ctrl-n next line in history (down-arrow)
74− ctrl-p previous line in history (up-arrow)
75− ctrl-r reverse-search
76− ctrl-t transpose characters
77− ctrl-u kill to beginning of line
78− ctrl-y yank from kill buffer
79−
80−Full coverage of the Urbit shell, the Dojo is covered in the [Shell walkthrough](/docs/using/shell).
77+```
78+Ctrl-a Cursor to beginning of the line (Home)
79+Ctrl-b Cursor one character backward (left-arrow)
80+Ctrl-e Cursor to the end of the line (End)
81+Ctrl-f Cursor one character forward (right-arrow)
82+Ctrl-g Beep; cancel reverse-search
83+Ctrl-k Kill to end of line
84+Ctrl-l Clear the screen
85+Ctrl-n Next line in history (down-arrow)
86+Ctrl-p Previous line in history (up-arrow)
87+Ctrl-r Reverse-search
88+Ctrl-t Transpose characters
89+Ctrl-u Kill to beginning of line
90+Ctrl-y Yank from kill buffer
91+```
92+
93+Full coverage of the Urbit shell, the Dojo is covered in the
94+[Shell walkthrough](../shell/).
8195
8296## Web
8397
84−On startup Urbit tries to bind to `localhost:8080`. If you're already running something on `8080` you'll find your Urbit on `8081`, and so on. For planets only, we also proxy web domains through Urbit's own servers. Any planet `~your-urbit` is also at
85−`your-urbit.urbit.org`.
98+On startup Urbit tries to bind to `localhost:8080`. If you're already
99+running something on `8080` you'll find your Urbit on `8081`, and so on.
100+For planets only, we also proxy web domains through Urbit's own servers.
101+Any planet `~your-urbit` is also at `your-urbit.urbit.org`.
86102
87−Your Urbit serves a simple homepage from `http://localhost:8080` or `https://your-urbit.urbit.org` that should be self-explanatory. Since our HTTPS isn't audited / battle tested we just call it "secure" HTTPS. You can find that on `8443`. Or `8444` (and so on) if you're already running something on `8443`.
103+Your Urbit serves a simple homepage from `http://localhost:8080` or
104+`https://your-urbit.urbit.org` that should be self-explanatory. Since
105+our HTTPS isn't audited / battle tested we just call it "secure" HTTPS.
106+You can find that on `8443`. Or `8444` (and so on) if you're already
107+running something on `8443`.
88108
89−A complete walkthrough of the Urbit web interface is [here](/docs/using/web).
109+A complete walkthrough of the Urbit web interface is
110+[here](../web/).
90111
91112## Continuity breaches
92113
93−While the Urbit network is in this alpha state we sometimes have to reboot the whole network. This happens either when major changes need to be shipped or we hit a bug that can't be fixed over the air.
114+While the Urbit network is in this alpha state we sometimes have to
115+reboot the whole network. This happens either when major changes need
116+to be shipped or we hit a bug that can't be fixed over the air.
94117
95−Because Urbit networking is stateful we call this a 'continuity breach'. Everything has to be restarted from scratch. Your pier will continue to function after we have breached, but it wont connect to the rest of the Urbit network.
118+Because Urbit networking is stateful we call this a _continuity breach_.
119+Everything has to be restarted from scratch. Your pier will continue to
120+function after we have breached, but it wont connect to the rest of the
121+Urbit network.
96122
97−When this happens, back up any files you'd like to save, shut down your Urbit and recreate it (as if you were starting for the first time).
123+When this happens, back up any files you'd like to save, shut down your
124+Urbit and recreate it (as if you were starting for the first time).