@@ -4,9 +4,10 @@ weight = 2
4description = "Installation instructions for power users."
4description = "Installation instructions for power users."
7−If you're a power user, you can run the Urbit virtual machine directly using the
7+If you're a power user, you can run the Urbit runtime (Vere) using the command
8−command line. This can be run on your local machine or a server in the cloud, we
8+line. This can be run on your local machine or a server in the cloud, we
9−just cover the general case here.
9+just cover the local case here. The runtime is what interprets the Urbit kernel
10+code (Arvo) into commands your specific machine (macOS or Linux) understands.
11Note there is a much more comprehensive [cloud hosting
12Note there is a much more comprehensive [cloud hosting
12guide](https://operators.urbit.org/manual/running/hosting) which walks through
13guide](https://operators.urbit.org/manual/running/hosting) which walks through
@@ -35,7 +36,8 @@ will still run fine, but you may run out of space some months down the line.
35### 2. Install Urbit
36### 2. Install Urbit
37Choose your operating system and run the given command in your terminal to
38Choose your operating system and run the given command in your terminal to
38−download the Urbit runtime:
39+download the Urbit runtime, this command downloads the latest build, unpacks
40+it, and runs the binary with no arguments to show you the help output:
@@ -45,8 +47,8 @@ download the Urbit runtime:
45curl -L https://urbit.org/install/linux-x86_64/latest | tar xzk --transform='s/.*/urbit/g' && ./urbit
47curl -L https://urbit.org/install/linux-x86_64/latest | tar xzk --transform='s/.*/urbit/g' && ./urbit
48−> Linux users may need to run this command in another terminal window to access
50+> Linux users need to run this command in another terminal window to access
49−> your urbit on port 80:
51+> your urbit on port 80, otherwise it'll default to port 8080:
52> sudo apt-get install libcap2-bin
54> sudo apt-get install libcap2-bin
@@ -61,8 +63,8 @@ curl -L https://urbit.org/install/linux-x86_64/latest | tar xzk --transform='s/.
61curl -L https://urbit.org/install/linux-aarch64/latest | tar xzk --transform='s/.*/urbit/g' && ./urbit
63curl -L https://urbit.org/install/linux-aarch64/latest | tar xzk --transform='s/.*/urbit/g' && ./urbit
64−> Linux users may need to run this command in another terminal window to access
66+> Linux users need to run this command in another terminal window to access
65−> your urbit on port 80:
67+> your urbit on port 80, otherwise it'll default to port 8080:
68> sudo apt-get install libcap2-bin
70> sudo apt-get install libcap2-bin
@@ -128,8 +130,8 @@ comet can be booted with the `-c` option:
128./urbit -c mycomet
130./urbit -c mycomet
131−> `mycomet` will be the name given to the data folder it will create. You can
133+> `mycomet` will be the name given to the folder it will create.
132−> choose any name you like.
134+> You can choose any name you like.
134It may take a while to initialize the comet (usually only a couple of minutes,
136It may take a while to initialize the comet (usually only a couple of minutes,
135but it could take longer). When it's done, it'll take you to the dojo prompt
137but it could take longer). When it's done, it'll take you to the dojo prompt
@@ -158,9 +160,9 @@ idea to enable updates with the following command in the dojo:
158|ota (sein:title our now our)
160|ota (sein:title our now our)
161−Lastly, while the dojo is quite powerful, most people use their urbit via
163+Lastly most people use their urbit via Landscape, the browser-based UI. In order
162−Landscape, the browser-based UI. In order to access Landscape, you need your web
164+to access Landscape, you need your web login code. You can get this by running
163−login code. You can get this by running the following command in the dojo:
165+the following command in the dojo:
@@ -189,7 +191,7 @@ keyfile):
189./urbit -w sampel-palnet -k sampel-palnet-1.key
191./urbit -w sampel-palnet -k sampel-palnet-1.key
192−This will create a data folder with the name of your planet and begin booting.
194+This will create a folder with the name of your planet and begin booting.
193It may take a while to initialize the planet (usually only a couple of minutes,
195It may take a while to initialize the planet (usually only a couple of minutes,
194but it could take longer). When it's done, it'll take you to the dojo prompt
196but it could take longer). When it's done, it'll take you to the dojo prompt
195(the dojo is Urbit's shell):
197(the dojo is Urbit's shell):
@@ -209,8 +211,8 @@ folder, so you can start it up again by doing:
209./sampel-palnet/.run
211./sampel-palnet/.run
212−While the dojo is quite powerful, most people use their urbit via Landscape, the
214+Most people use their urbit via Landscape, the browser-based UI.
213−browser-based UI. In order to access Landscape, you need your web login code.
215+In order to access Landscape, you need your web login code.
214You can get this by running the following command in the dojo:
216You can get this by running the following command in the dojo:
@@ -222,8 +224,8 @@ It'll spit out a code that'll look something like `lidlut-tabwed-pillex-ridrup`
222to the clipboard.
224to the clipboard.
224One last thing: The `sampel-palnet-1.key` keyfile is only needed once, when you
226One last thing: The `sampel-palnet-1.key` keyfile is only needed once, when you
225−first boot your planet. Now that it's booted, it's good security practice to
227+first boot your planet. **Now that it's booted, it's good security practice to
226−delete that keyfile.
228+delete that keyfile.**
228{% /tab %}
230{% /tab %}
@@ -244,8 +246,42 @@ Whichever address and port it says there is the one to open in the browser.
245Once open, you'll be presented with the login screen. Paste in the web login
247Once open, you'll be presented with the login screen. Paste in the web login
246code you copied from the dojo in the previous step and hit "continue". You'll
248code you copied from the dojo in the previous step and hit "continue". You'll
247−now be taken to your homescreen, with tiles for the default apps such as Groups
249+now be taken to your homescreen, with tiles for the default apps such as Groups,
248−and Terminal.
250+Talk, and Terminal.
252+### 5. Runtime Upgrades
254+When new versions of the Urbit runtime (Vere) are available, you'll have to
255+shutdown your urbit and then run the `next` command in order to upgrade.
260+Note that `<pier>` in this case is the folder that was created when you first booted
261+your urbit. When you run this command your urbit will download the latest binary
262+and place it inside the `.bin` directory inside your pier folder. You can then
263+start your ship with the following and you'll be on the latest runtime version:
267+> Linux users need to run this command in another terminal window to access
268+> your urbit on port 80 every time you upgrade your runtime (otherwise it'll
269+> default to port 8080):
272+> sudo apt-get install libcap2-bin
273+> sudo setcap 'cap_net_bind_service=+ep' ./urbit
276+If you've been running Urbit for a while (from before runtime version 1.9)
277+and these `.run` commands don't work for you, it probably means you need to
278+[dock](https://operators.urbit.org/manual/running/vere#dock) your pier.
279+You can do this with the following command:
283+Then `.run` should work as expected and future runtime upgrades can be done via
250### Next steps
286### Next steps