git.iko.soy/urbit.org
on master help sign in
getting started: split instructions for power users
9303369Matilde Park
content/docs+1−1
compare with master
unifiedsplit

Submodule changed.

content/getting-started/_index.md+35−165
@@ -6,209 +6,79 @@ page_template = "page_indiced.html"
6template = "getting-started/index.html"
6template = "getting-started/index.html"
7+++
7+++
8
8
9−The price of using other platforms is your data and its security. There's a reason they're free to use.
9+If you use Mac or Linux and just want to jump in, you can download **Port** and install it to run Urbit for you and get going right away. You can also set up Urbit using the command line.
10
10
11−The price of using Urbit is your own responsibility — you must run it yourself (or pay someone to run it for you).
11+If you run Windows, or just want to give it a shot without worrying about the gritty bits, you may want to consider a [hosting provider](@/getting-started/planet.md#hosting-providers), though Windows instructions are provided [for power users](@cli.md).
12
12
13−It's easy and it keeps getting easier.
13+### Get Port {#port}
14
14
15−There are currently two ways to run Urbit:
15+**Port** is a desktop GUI application that allows you to spin up, access, and manage your Urbit ships without any knowledge of the command line or Urbit binary.
16
16
17−If you use Mac or Linux and are not afraid of a few terminal commands, we recommend you run it yourself. That is the aim of this guide.
18−
19−If you run Windows or just want to give it a shot without worrying about the gritty bits, you may want to consider a [hosting provider](@/getting-started/planet.md#hosting-providers).
20−
21−## Installing Urbit {#macos-and-linux}
22−
23−Choose the code for your operating system and run the commands in your terminal.
24−
25−<div id="os">
17+<div id="port-os" class="os mv3">
26− <input type="radio" id="macos" name="os" checked>
18+ <input type="radio" id="port-macos" name="port-os" checked>
27− <label for="macos">MacOS</label>
19+ <label for="port-macos">MacOS</label>
28 <div class="tab">
20 <div class="tab">
29−
21+ <p>To install <strong>Port</strong> on MacOS simply download and open the <code>.dmg</code> file.</p>
30−```sh
22+ <a href="https://github.com/arthyn/taisho/releases/latest/download/taisho.dmg" class="dib ph3 ba b--gray3 br2">
31−mkdir ~/urbit
23+ Download Port
32−cd ~/urbit
24+ <svg class="dib ml1" viewBox="0 0 842 1000" width="13.5" height="14" xmlns="http://www.w3.org/2000/svg"><path fill="#000000" d="M702 960c-54.2 52.6-114 44.4-171 19.6-60.6-25.3-116-26.9-180 0-79.7 34.4-122 24.4-170-19.6-271-279-231-704 77-720 74.7 4 127 41.3 171 44.4 65.4-13.3 128-51.4 198-46.4 84.1 6.8 147 40 189 99.7-173 104-132 332 26.9 396-31.8 83.5-72.6 166-141 227zM423 237C414.9 113 515.4 11 631 1c15.9 143-130 250-208 236z"/></svg>
33−curl -JLO https://urbit.org/install/mac/latest
25+ </a>
34−tar zxvf ./darwin.tgz --strip=1
35−~/urbit/urbit
36−```
37 </div>
26 </div>
38
27
39− <input type="radio" id="linux" name="os">
28+ <input type="radio" id="port-linux" name="port-os">
40− <label for="linux">Linux</label>
29+ <label for="port-linux">Linux</label>
41 <div class="tab">
30 <div class="tab">
42
31
43−```sh
32+We use `snap` so that **Port** can stay updated automatically. If you already have `snap` installed, simply run:
44−mkdir ~/urbit
45−cd ~/urbit
46−wget --content-disposition https://urbit.org/install/linux64/latest
47−tar zxvf ./linux64.tgz --strip=1
48−~/urbit/urbit
49−```
50−
51−Linux users may need to run this command in another terminal window to access your Urbit on port 80:
52
33
53```sh
34```sh
54−sudo apt-get install libcap2-bin
35+sudo snap install port
55−sudo setcap 'cap_net_bind_service=+ep' ~/urbit/urbit
56```
36```
57−</div>
58−
59− <input type="radio" id="windows" name="os">
60− <label for="windows">Windows</label>
61− <div class="tab">
62
37
63−> Please note that this method of installing Urbit is experimental, and we may not be able to assist you if you encounter issues related to WSL 2.
38+Or to install `snap` for your distribution, snapcraft provides [installation instructions](https://snapcraft.io/docs/installing-snapd).
64
39
65−Urbit cannot run on Windows itself, but there is a convenient way to run Linux using the [Windows Subsystem for Linux 2](https://docs.microsoft.com/en-us/windows/wsl/wsl2-install) on Windows 10. Install the Windows Subsystem for Linux 2 and open a Linux terminal in Windows, then follow the Linux installation instructions below. These instructions have been tested and verified for WSL 2 + Ubuntu 18.04 LTS, as demonstrated in `~sitful-hatred`'s step-by-step setup guide [here](https://subject.network/posts/urbit-wsl2/).
66−
67−For performance reasons, do not install Urbit in the mounted Windows volume, but install it in the Linux file system. For example, in your home directory, which can be navigated to by entering `cd ~`.
68−</div>
40+ </div>
69</div>
41</div>
70
42
71<style>
43<style>
72− #os {
44+ .os {
73 display: flex;
45 display: flex;
74 flex-wrap: wrap;
46 flex-wrap: wrap;
75 }
47 }
76− #os label {
48+ .os label {
77 order: -1;
49 order: -1;
78 padding: .5rem;
50 padding: .5rem;
51+ min-width: 70px;
52+ text-align: center;
79 border-width: 1px 0px 0px 1px;
53 border-width: 1px 0px 0px 1px;
80 border-style: solid;
54 border-style: solid;
81 cursor: pointer;
55 cursor: pointer;
82 }
56 }
83− #os label[for=windows] {
57+ .os label:last-of-type {
84 border-right-width: 1px;
58 border-right-width: 1px;
85 }
59 }
86− #os input[type="radio"] {
60+ .os input[type="radio"] {
87 display: none;
61 display: none;
88 }
62 }
89− #os .tab {
63+ .os .tab {
90 display: none;
64 display: none;
91 border: 1px solid;
65 border: 1px solid;
92 padding: 1rem;
66 padding: 1rem;
67+ width: 100%;
93 max-width: 100%;
68 max-width: 100%;
94 }
69 }
70+ .os .tab p:first-child {
71+ margin-top: 0;
72+ }
73+ .os .tab p:last-child {
74+ margin-bottom: 0;
75+ }
95− #os input[type='radio']:checked + label {
76+ .os input[type='radio']:checked + label {
96 font-weight: bold;
77 font-weight: bold;
97 }
78 }
98− #os input[type='radio']:checked + label + .tab {
79+ .os input[type='radio']:checked + label + .tab {
99 display: block;
80 display: block;
100}
81}
101</style>
82</style>
102
83
103−If successful, you will see a block of output beginning with the line:
84+If you'd like to have more direct control over the Urbit virtual machine, or are setting up Urbit on a cloud droplet, try [installation using the command line](@cli.md).
104−
105−```
106−Urbit: a personal server operating function
107−```
108−
109−## Booting a Free Identity {#comet}
110−
111−There are two parts to Urbit: an **ID** and an **Operating System**.
112−
113−You have just installed the Operating System on your computer.
114−
115−The **ID** is similar to a username and password on another site. The difference is that the public part (the username) is verified by thousands of people around the world while only you hold the key (the password) to that ID.
116−
117−There are five kinds of Urbit IDs but to get started you only need to know about two: we call them **planets** and **comets**.
118−
119−***
120−
121−**Planets** are scarce (this prevents spamming, among other things) and usually require a price to acquire. This is the recommended way to run Urbit, but it's a bit more involved.
122−
123−A planet name looks like `~sampel-palnet`.
124−
125−[Follow this guide](@/getting-started/planet.md) if you have already acquired a planet.
126−
127−[Find a planet to purchase](@/getting-started/planet.md#purchase)
128−
129−***
130−
131−**Comets** are practically unlimited and free to acquire. At present, these are a great way to try out the network for free.
132−
133−A comet name looks like `~dasres-ragnep-lislyt-ribpyl--mosnyx-bisdem-nidful-marzod`.
134−
135−[Read more about Urbit ID here](/understanding-urbit/urbit-id)
136−
137−
138−***
139−
140−To boot a comet, go into the command line and run the following command from the `urbit` directory you created during [Urbit installation](#installing-urbit):
141−
142−```sh
143−~/urbit/urbit -c mycomet
144−```
145−
146−It may take a while to load the comet (probably only take a few minutes, but it could take longer). This comes along with it being free. When it's done you'll some messages ending like this:
147−
148−```
149−ames: on localhost, UDP 31337.
150−http: live (insecure, public) on 8080
151−http: live ("secure", public) on 8443
152−http: live (insecure, loopback) on 12321
153−~sampel_marzod:dojo>
154−```
155−
156−When your comet is finished booting, you will see `~sampel_marzod:dojo>` (Dojo: the Urbit command line).
157−
158−To exit Urbit, use `Ctrl-D` or enter `|exit` into Dojo.
159−
160−To start your comet up again, run the following from your `urbit` directory (note the lack of `-c` argument):
161−
162−```sh
163−~/urbit/urbit mycomet
164−```
165−
166−## Using Landscape
167−
168−Urbit is an entirely new computer, so by default it drops you into the "dojo," which is its terminal. Like your current computer, it can be used to do just about anything if you know the right commands. You only need to know one command for now.
169−
170−At the moment, the most common way to use Urbit is through a web app named [Landscape](@/docs/glossary/landscape.md), which comes with Urbit. It runs in your browser and provides an interface to Urbit without using the terminal. You need to get the password, or `code`.
171−
172−1. With your Urbit running, look for a line that says something like `http: live (insecure, public) on 80`. The number given is the port that your ship is using. It will probably be 80, but we're just making sure. (Don't worry about the "insecure, public" part — that just means you can access it from your own web browser. It doesn't give anyone else access.)
173−2. If the port given is `80`, simply type `localhost` into your browser's address bar. If the given port is a different number, such as `8080`, you would type `localhost:8080`. You'll be met with a login prompt.
174−3. In the window where you found the port number, type `+code` and press return. Copy-paste the code that appears into the "Access Key" field in the browser, and press continue.
175−4. Once in, take a look around and read the instructions on screen. If you ever get logged out, follow these instructions again.
176−
177−## Next Steps
178−
179−### Updating your comet {#updating}
180−
181−The Urbit application comes with a recent release of the Urbit OS, but automatic updates ("over the air") can be enabled so new binaries aren't necessary for each update. Planets have automatic updates enabled by default, but this is not the case for comets. Many comets are used only once and thrown away, so it would be wasteful to update every single comet as soon as it boots. If you plan to use your comet for more than a quick test, you'll probably want to ensure you're running the latest version of the OS.
182−
183−You can enable updates for your comet by typing `|ota (sein:title our now our) %kids` into Dojo and pressing Enter.
184−
185−```
186−> |ota (sein:title our now our) %kids
187−>=
188−```
189−
190−If you want to make sure you'll get updates, you can check by typing `|ota` with no arguments:
191−
192−```
193−~sampel_marzod:dojo> |ota
194−OTAs enabled from %kids on ~marzod
195−use |ota %disable or |ota ~sponsor %kids to reset it
196−> |ota
197−>=
198−```
199−
200−### Read More about the Dojo {#the-dojo}
201−
202−The dojo is Urbit's command line. You can use it to control your ship, or to execute arbitrary code. Check out the links below for more information.
203−
204−- [Basic Operations](@/using/os/getting-started.md)
205−- [Basic Hoon](/docs/tutorials/hoon/hoon-school/setup)
206−- [Glossary Entry](/docs/glossary/dojo)
207−
208−### Purchase a Permanent Identity {#boot-your-planet}
209−
210−You can continue using this comet indefinitely. There are currently few differences between using a comet-level identity and a planet-level one. However, some groups will not allow comets entry in order to maintain a certain level of quality, and changes may be made in the future that further devalue comets. They will always, however, be able to access the basic functions of the network.
211−
212−A comet also comes with a long and fairly unmemorable name whereas a planet has a short name and a "sigil" (avatar) associated with it that makes it more identifiable on the network. You may notice all this within the first few minutes of using Urbit.
213−
214−[To read instructions on how to purchase and use a planet, visit this page](@/getting-started/planet.md).
content/getting-started/cli.mdnew file+208
@@ -0,0 +1,208 @@
1++++
2+title = "Installing Urbit using the command line"
3+weight = 2
4+description = "Installation instructions for power users."
5++++
6+
7+If you're a power user, you can run the Urbit virtual machine directly using the command line. Choose the code for your operating system and run the commands in your terminal.
8+
9+<div id="os" class="os">
10+ <input type="radio" id="macos" name="os" checked>
11+ <label for="macos">MacOS</label>
12+ <div class="tab">
13+
14+```sh
15+mkdir ~/urbit
16+cd ~/urbit
17+curl -JLO https://urbit.org/install/mac/latest
18+tar zxvf ./darwin.tgz --strip=1
19+~/urbit/urbit
20+```
21+ </div>
22+
23+ <input type="radio" id="linux" name="os">
24+ <label for="linux">Linux</label>
25+ <div class="tab">
26+
27+```sh
28+mkdir ~/urbit
29+cd ~/urbit
30+wget --content-disposition https://urbit.org/install/linux64/latest
31+tar zxvf ./linux64.tgz --strip=1
32+~/urbit/urbit
33+```
34+
35+Linux users may need to run this command in another terminal window to access your Urbit on port 80:
36+
37+```sh
38+sudo apt-get install libcap2-bin
39+sudo setcap 'cap_net_bind_service=+ep' ~/urbit/urbit
40+```
41+</div>
42+
43+ <input type="radio" id="windows" name="os">
44+ <label for="windows">Windows</label>
45+ <div class="tab">
46+
47+> Please note that this method of installing Urbit is experimental, and we may not be able to assist you if you encounter issues related to WSL 2.
48+
49+Urbit cannot run on Windows itself, but there is a convenient way to run Linux using the [Windows Subsystem for Linux 2](https://docs.microsoft.com/en-us/windows/wsl/wsl2-install) on Windows 10. Install the Windows Subsystem for Linux 2 and open a Linux terminal in Windows, then follow the Linux installation instructions below. These instructions have been tested and verified for WSL 2 + Ubuntu 18.04 LTS, as demonstrated in `~sitful-hatred`'s step-by-step setup guide [here](https://subject.network/posts/urbit-wsl2/).
50+
51+For performance reasons, do not install Urbit in the mounted Windows volume, but install it in the Linux file system. For example, in your home directory, which can be navigated to by entering `cd ~`.
52+</div>
53+</div>
54+
55+If successful, you will see a block of output beginning with the line:
56+
57+```
58+Urbit: a personal server operating function
59+```
60+
61+### Booting a free identity {#comet}
62+
63+There are two parts to Urbit: an **ID** and an **Operating System**.
64+
65+You have just installed the Operating System on your computer.
66+
67+The **ID** is similar to a username and password on another site. The difference is that the public part (the username) is verified by thousands of people around the world while only you hold the key (the password) to that ID.
68+
69+There are five kinds of Urbit IDs but to get started you only need to know about two: we call them **planets** and **comets**.
70+
71+***
72+
73+**Planets** are scarce (this prevents spamming, among other things) and usually require a price to acquire. This is the recommended way to run Urbit, but it's a bit more involved.
74+
75+A planet name looks like `~sampel-palnet`.
76+
77+[Follow this guide](@/getting-started/planet.md) if you have already acquired a planet.
78+
79+[Find a planet to purchase](@/getting-started/planet.md#purchase)
80+
81+***
82+
83+**Comets** are practically unlimited and free to acquire. At present, these are a great way to try out the network for free.
84+
85+A comet name looks like `~dasres-ragnep-lislyt-ribpyl--mosnyx-bisdem-nidful-marzod`.
86+
87+[Read more about Urbit ID here](/understanding-urbit/urbit-id)
88+
89+
90+***
91+
92+To boot a comet, go into the command line and run the following command from the `urbit` directory you created during [Urbit installation](#installing-urbit):
93+
94+```sh
95+~/urbit/urbit -c mycomet
96+```
97+
98+It may take a while to load the comet (probably only take a few minutes, but it could take longer). This comes along with it being free. When it's done you'll some messages ending like this:
99+
100+```
101+ames: on localhost, UDP 31337.
102+http: live (insecure, public) on 8080
103+http: live ("secure", public) on 8443
104+http: live (insecure, loopback) on 12321
105+~sampel_marzod:dojo>
106+```
107+
108+When your comet is finished booting, you will see `~sampel_marzod:dojo>` (Dojo: the Urbit command line).
109+
110+To exit Urbit, use `Ctrl-D` or enter `|exit` into Dojo.
111+
112+To start your comet up again, run the following from your `urbit` directory (note the lack of `-c` argument):
113+
114+```sh
115+~/urbit/urbit mycomet
116+```
117+
118+### Using Landscape
119+
120+Urbit is an entirely new computer, so by default it drops you into the "dojo," which is its terminal. Like your current computer, it can be used to do just about anything if you know the right commands. You only need to know one command for now.
121+
122+At the moment, the most common way to use Urbit is through a web app named [Landscape](@/docs/glossary/landscape.md), which comes with Urbit. It runs in your browser and provides an interface to Urbit without using the terminal. You need to get the password, or `code`.
123+
124+1. With your Urbit running, look for a line that says something like `http: live (insecure, public) on 80`. The number given is the port that your ship is using. It will probably be 80, but we're just making sure. (Don't worry about the "insecure, public" part — that just means you can access it from your own web browser. It doesn't give anyone else access.)
125+2. If the port given is `80`, simply type `localhost` into your browser's address bar. If the given port is a different number, such as `8080`, you would type `localhost:8080`. You'll be met with a login prompt.
126+3. In the window where you found the port number, type `+code` and press return. Copy-paste the code that appears into the "Access Key" field in the browser, and press continue.
127+4. Once in, take a look around and read the instructions on screen. If you ever get logged out, follow these instructions again.
128+
129+## Next Steps
130+
131+### Updating your comet {#updating}
132+
133+The Urbit application comes with a recent release of the Urbit OS, but automatic updates ("over the air") can be enabled so new binaries aren't necessary for each update. Planets have automatic updates enabled by default, but this is not the case for comets. Many comets are used only once and thrown away, so it would be wasteful to update every single comet as soon as it boots. If you plan to use your comet for more than a quick test, you'll probably want to ensure you're running the latest version of the OS.
134+
135+You can enable updates for your comet by typing `|ota (sein:title our now our) %kids` into Dojo and pressing Enter.
136+
137+```
138+> |ota (sein:title our now our) %kids
139+>=
140+```
141+
142+If you want to make sure you'll get updates, you can check by typing `|ota` with no arguments:
143+
144+```
145+~sampel_marzod:dojo> |ota
146+OTAs enabled from %kids on ~marzod
147+use |ota %disable or |ota ~sponsor %kids to reset it
148+> |ota
149+>=
150+```
151+
152+### Read More about the Dojo {#the-dojo}
153+
154+The dojo is Urbit's command line. You can use it to control your ship, or to execute arbitrary code. Check out the links below for more information.
155+
156+- [Basic Operations](@/using/os/getting-started.md)
157+- [Basic Hoon](/docs/tutorials/hoon/hoon-school/setup)
158+- [Glossary Entry](/docs/glossary/dojo)
159+
160+### Purchase a Permanent Identity {#boot-your-planet}
161+
162+You can continue using this comet indefinitely. There are currently few differences between using a comet-level identity and a planet-level one. However, some groups will not allow comets entry in order to maintain a certain level of quality, and changes may be made in the future that further devalue comets. They will always, however, be able to access the basic functions of the network.
163+
164+A comet also comes with a long and fairly unmemorable name whereas a planet has a short name and a "sigil" (avatar) associated with it that makes it more identifiable on the network. You may notice all this within the first few minutes of using Urbit.
165+
166+[To read instructions on how to purchase and use a planet, visit this page](@/getting-started/planet.md).
167+
168+
169+<style>
170+ .os {
171+ display: flex;
172+ flex-wrap: wrap;
173+ }
174+ .os label {
175+ order: -1;
176+ padding: .5rem;
177+ min-width: 70px;
178+ text-align: center;
179+ border-width: 1px 0px 0px 1px;
180+ border-style: solid;
181+ cursor: pointer;
182+ }
183+ .os label:last-of-type {
184+ border-right-width: 1px;
185+ }
186+ .os input[type="radio"] {
187+ display: none;
188+ }
189+ .os .tab {
190+ display: none;
191+ border: 1px solid;
192+ padding: 1rem;
193+ width: 100%;
194+ max-width: 100%;
195+ }
196+ .os .tab p:first-child {
197+ margin-top: 0;
198+ }
199+ .os .tab p:last-child {
200+ margin-bottom: 0;
201+ }
202+ .os input[type='radio']:checked + label {
203+ font-weight: bold;
204+ }
205+ .os input[type='radio']:checked + label + .tab {
206+ display: block;
207+}
208+</style>
content/getting-started/planet.md+3−3
@@ -1,5 +1,5 @@
1+++
1+++
2−title = "Setting up Your Planet"
2+title = "Setting up your planet"
3weight = 1
3weight = 1
4description = "Getting started with a permanent Urbit identity."
4description = "Getting started with a permanent Urbit identity."
5+++
5+++
@@ -60,13 +60,13 @@ and copy the key inside. Paste it into the following command, except with
60the name of your planet. **Do not include the tilde in your planet name.**
60the name of your planet. **Do not include the tilde in your planet name.**
61
61
62```sh
62```sh
63−./urbit -p ames_port -w sampel-palnet -G rAnDoMkEy
63+./urbit -p ames_port -w sampel-palnet -G rAnDoMkEy
64```
64```
65
65
66Or you can copy the keyfile into the current directory and run:
66Or you can copy the keyfile into the current directory and run:
67
67
68```sh
68```sh
69−./urbit -p ames_port -w sampel-palnet -k ./my-planet.key
69+./urbit -p ames_port -w sampel-palnet -k ./my-planet.key
70```
70```
71
71
72Either command will create a directory called `sampel-palnet/` and begin booting your planet. It may take a few minutes.
72Either command will create a directory called `sampel-palnet/` and begin booting your planet. It may take a few minutes.
content/reset.md+2−2
@@ -77,8 +77,8 @@ Yes, by following these steps (note that these steps **will not** back up your d
771. Download your [keyfile from Bridge](https://urbit.org/getting-started/#keyfile).
771. Download your [keyfile from Bridge](https://urbit.org/getting-started/#keyfile).
782. Shut down your ship.
782. Shut down your ship.
793. [Archive and move your old pier](@/using/os/getting-started.md#moving-your-pier) (this is the directory that contains your urbit event log).
793. [Archive and move your old pier](@/using/os/getting-started.md#moving-your-pier) (this is the directory that contains your urbit event log).
80−4. [Download the latest version](@/getting-started/_index.md#macos-and-linux) of the urbit binary.
80+4. [Download the latest version](@/getting-started/_index.md) of the urbit binary.
81−5. [Boot your ship with the new keyfile](@/getting-started/_index.md#boot-your-planet).
81+5. [Boot your ship with the new keyfile](@/getting-started/_index.md).
82
82
83## I’m hosted by Tlon, or someone else—what do I need to do?
83## I’m hosted by Tlon, or someone else—what do I need to do?
84
84
content/understanding-urbit/interface.md+10−10
@@ -12,9 +12,9 @@ We built Urbit OS + Urbit ID to be the software stack for human-scale computing
12
12
13This is why we built Landscape: a simple, calm, browser-based interface for building digital communities. We use Landscape to bring together our separate ways of communicating and collaborating.
13This is why we built Landscape: a simple, calm, browser-based interface for building digital communities. We use Landscape to bring together our separate ways of communicating and collaborating.
14
14
15−Landscape isn’t just an idea—it’s a real thing. Today, once you have an Urbit OS node up and running, you can access Landscape from a desktop or mobile browser to pseudonymously chat, write, and share links with a group of friends.
15+Landscape isn’t just an idea—it’s a real thing. Today, once you have an Urbit OS node up and running, you can access Landscape from a desktop or mobile browser to pseudonymously chat, write, and share links with a group of friends.
16
16
17−We see Landscape as a new form of social software that can continue to grow and evolve for quite some time. We use the first version of Landscape, ‘OS 1’ every day. OS 1 is simple to the point of being simplistic. We look forward to evolving Landscape for a long time.
17+We see Landscape as a new form of social software that can continue to grow and evolve for quite some time. We use the first version of Landscape, ‘OS 1’ every day. OS 1 is simple to the point of being simplistic. We look forward to evolving Landscape for a long time.
18
18
19Landscape is by no means the only possible interface for Urbit OS + Urbit ID, but it’s the one that we need the most. In the future, we look forward to there being lots of different Urbit interfaces (and if you’re at all interested in experimenting with building one, please do.)
19Landscape is by no means the only possible interface for Urbit OS + Urbit ID, but it’s the one that we need the most. In the future, we look forward to there being lots of different Urbit interfaces (and if you’re at all interested in experimenting with building one, please do.)
20
20
@@ -31,11 +31,11 @@ Above all else, our digital lives today are missing a sense of place, a sense of
31
31
32It’s annoying and confusing to switch between interfaces, you can’t extend or build on top, and privacy and security are out of your hands. This fragmented, siloed, closely surveilled experience is simply a byproduct of having other people run and control your software. For the ordinary user, the result is restrictive, boring, and painful to manage. The possibility for everyday creativity with the tools we’re stuck with is close to zero. Wasn’t the computer supposed to be a bicycle for the mind?
32It’s annoying and confusing to switch between interfaces, you can’t extend or build on top, and privacy and security are out of your hands. This fragmented, siloed, closely surveilled experience is simply a byproduct of having other people run and control your software. For the ordinary user, the result is restrictive, boring, and painful to manage. The possibility for everyday creativity with the tools we’re stuck with is close to zero. Wasn’t the computer supposed to be a bicycle for the mind?
33
33
34−Operating systems for the PC took the desk of the 1970s and made it digital. Paper, drawers, and envelopes became ‘files’ and ‘folders’. It’s a great abstraction, but it’s ancient. We live in a connected, multiplayer world; we need an operating system that acknowledges this world.
34+Operating systems for the PC took the desk of the 1970s and made it digital. Paper, drawers, and envelopes became ‘files’ and ‘folders’. It’s a great abstraction, but it’s ancient. We live in a connected, multiplayer world; we need an operating system that acknowledges this world.
35
35
36The ‘desk’ of today is cluttered with apps and services, data structures, and interfaces. Unifying this disjointed user experience is the most important problem that a platform like Urbit can solve. Landscape is built to bring everything together into a unified interface again. Without Urbit ID + Urbit OS, this would be impossible.
36The ‘desk’ of today is cluttered with apps and services, data structures, and interfaces. Unifying this disjointed user experience is the most important problem that a platform like Urbit can solve. Landscape is built to bring everything together into a unified interface again. Without Urbit ID + Urbit OS, this would be impossible.
37
37
38−In March 2020 we shipped the first public version of Landscape, OS 1, to the network and have been using it ever since to communicate, collaborate, and keep in touch.
38+In March 2020 we shipped the first public version of Landscape, OS 1, to the network and have been using it ever since to communicate, collaborate, and keep in touch.
39
39
40OS 1 is a minimal, multipurpose interface for bringing a group together to chat, share links, write and engage in discussion. OS 1 is free of any ads, tracking, or surveillance (as is the norm for anything built on Urbit). OS 1 is a stripped-down social utility designed for high-trust, direct communication and collaboration. OS 1 is the place for small communities to feel at home.
40OS 1 is a minimal, multipurpose interface for bringing a group together to chat, share links, write and engage in discussion. OS 1 is free of any ads, tracking, or surveillance (as is the norm for anything built on Urbit). OS 1 is a stripped-down social utility designed for high-trust, direct communication and collaboration. OS 1 is the place for small communities to feel at home.
41
41
@@ -43,7 +43,7 @@ OS 1 is a minimal, multipurpose interface for bringing a group together to chat,
43
43
44We built OS 1 for ourselves. We were sick of using centralized, mainstream software. We didn’t want to be stuck switching between bloated, monolithic services in order to keep in touch and move our work forward. We were done relying on some third party to take care of our community—so we exited to Urbit, and it feels good.
44We built OS 1 for ourselves. We were sick of using centralized, mainstream software. We didn’t want to be stuck switching between bloated, monolithic services in order to keep in touch and move our work forward. We were done relying on some third party to take care of our community—so we exited to Urbit, and it feels good.
45
45
46−If you’re curious to get a complete overview of OS 1, check out [this post](https://urbit.org/blog/introducing-os1/), watch the [release event](https://www.youtube.com/watch?v=71ViyftPkGk&feature=youtu.be&t=3963) or feel free to [boot a node](@/getting-started/_index.md#comet) to come talk to us.
46+If you’re curious to get a complete overview of OS 1, check out [this post](https://urbit.org/blog/introducing-os1/), watch the [release event](https://www.youtube.com/watch?v=71ViyftPkGk&feature=youtu.be&t=3963) or feel free to [boot a node](@/getting-started/_index.md) to come talk to us.
47
47
48(Running Urbit still requires a little fiddling around in the command-line, so it’s not for everyone—but we do have [plans for that to improve](https://urbit.org/blog/providers/).)
48(Running Urbit still requires a little fiddling around in the command-line, so it’s not for everyone—but we do have [plans for that to improve](https://urbit.org/blog/providers/).)
49
49
@@ -51,21 +51,21 @@ Our target with OS 1 was to produce the [Nokia 3310](https://en.wikipedia.org/wi
51
51
52<img class="ba" src="https://storage.googleapis.com/media.urbit.org/site/understanding-urbit/uu-interface-4.png">
52<img class="ba" src="https://storage.googleapis.com/media.urbit.org/site/understanding-urbit/uu-interface-4.png">
53
53
54−Landscape has two basic building blocks: groups and modules. A group is exactly what it sounds like: one or more people. A module is sort of like an app without the data lock-in. A module is just a tool for getting something done, like ‘tasks’, ‘links’ or ‘votes’ that’s shared by a group.
54+Landscape has two basic building blocks: groups and modules. A group is exactly what it sounds like: one or more people. A module is sort of like an app without the data lock-in. A module is just a tool for getting something done, like ‘tasks’, ‘links’ or ‘votes’ that’s shared by a group.
55
55
56−To give a few simple examples, a group of family members may just chat and share photos. A group of traders might share annotated research, watch the markets, and manage payments on a blockchain.
56+To give a few simple examples, a group of family members may just chat and share photos. A group of traders might share annotated research, watch the markets, and manage payments on a blockchain.
57
57
58−Today, Landscape only has a few modules that come out of the box: chat, links, and publish. Our plan is to keep expanding this suite such that the default suite of modules feels like a nicely balanced toolkit for building community and staying connected. We’d also like to make it easy for anyone to build their own module and share it with others directly over Urbit’s network.
58+Today, Landscape only has a few modules that come out of the box: chat, links, and publish. Our plan is to keep expanding this suite such that the default suite of modules feels like a nicely balanced toolkit for building community and staying connected. We’d also like to make it easy for anyone to build their own module and share it with others directly over Urbit’s network.
59
59
60The idea is this: any community should be able to customize their digital environment freely. For most users, this is just about choosing the right modules. For anyone with a bit of free time, adding your own modules should only be as difficult as building a simple webapp.
60The idea is this: any community should be able to customize their digital environment freely. For most users, this is just about choosing the right modules. For anyone with a bit of free time, adding your own modules should only be as difficult as building a simple webapp.
61
61
62−When we look forward to what we can do with Landscape in the future, it’s hard to see ourselves going back to the tools we use today. The centralized services we have now are like broadcast media: they’re for distributing content from a producer to a bunch of followers.
62+When we look forward to what we can do with Landscape in the future, it’s hard to see ourselves going back to the tools we use today. The centralized services we have now are like broadcast media: they’re for distributing content from a producer to a bunch of followers.
63
63
64Landscape is for everything else. Landscape is for actual two-way communication.
64Landscape is for everything else. Landscape is for actual two-way communication.
65
65
66<img class="ba" src="https://media.urbit.org/site/understanding-urbit/your-last-computer/your-last-computer-waves%402x.png">
66<img class="ba" src="https://media.urbit.org/site/understanding-urbit/your-last-computer/your-last-computer-waves%402x.png">
67
67
68−Our desire to build a single place to work together isn’t driven just by convenience
68+Our desire to build a single place to work together isn’t driven just by convenience
69(although it is quite convenient). The way we see it, [real communities need to have real ownership over the spaces they inhabit](https://urbit.org/blog/urbit-is-for-communities/). When communities use industrial-grade, one-size-fits-all software they feel as sterile as the software they use. That world always felt a bit like living in a planned community. We’d rather live in the countryside.
69(although it is quite convenient). The way we see it, [real communities need to have real ownership over the spaces they inhabit](https://urbit.org/blog/urbit-is-for-communities/). When communities use industrial-grade, one-size-fits-all software they feel as sterile as the software they use. That world always felt a bit like living in a planned community. We’d rather live in the countryside.
70
70
71We think Landscape can evolve into something even *more* powerful, cleaner, and more satisfying to use. Landscape is neither a social network nor productivity software. Landscape isn’t centrally controlled or passively surveilled. Landscape is something entirely new. It’s software that’s tailored to the people who use it, by the people who use it.
71We think Landscape can evolve into something even *more* powerful, cleaner, and more satisfying to use. Landscape is neither a social network nor productivity software. Landscape isn’t centrally controlled or passively surveilled. Landscape is something entirely new. It’s software that’s tailored to the people who use it, by the people who use it.
content/using/id/guide-to-breaches.md+2−2
@@ -34,7 +34,7 @@ personal breach, follow the steps below.
34- Download your new keyfile following these instructions: [Generate your
34- Download your new keyfile following these instructions: [Generate your
35 keyfile](@/using/id/using-bridge.md#generate-your-keyfile).
35 keyfile](@/using/id/using-bridge.md#generate-your-keyfile).
36- Delete or archive your old [pier](@/docs/glossary/pier.md).
36- Delete or archive your old [pier](@/docs/glossary/pier.md).
37−- Proceed to [boot your ship](@/getting-started/_index.md#boot-your-planet) with the new keyfile.
37+- Proceed to [boot your ship](@/getting-started/cli.md#boot-your-planet) with the new keyfile.
38- Delete your keyfile after successfully booting.
38- Delete your keyfile after successfully booting.
39- Rejoin your favorite chat channels and subscriptions.
39- Rejoin your favorite chat channels and subscriptions.
40
40
@@ -57,7 +57,7 @@ you are transferring to another address you own. The process here is slightly di
57 keyfile](@/using/id/using-bridge.md#generate-your-keyfile). The option
57 keyfile](@/using/id/using-bridge.md#generate-your-keyfile). The option
58 whether or not to breach is in the Accept your Transfer step.
58 whether or not to breach is in the Accept your Transfer step.
59- Delete or archive your old [pier](@/docs/glossary/pier.md).
59- Delete or archive your old [pier](@/docs/glossary/pier.md).
60−- Proceed to [boot your ship](@/getting-started/_index.md#boot-your-planet) with the new keyfile.
60+- Proceed to [boot your ship](@/getting-started/cli.md#boot-your-planet) with the new keyfile.
61- Delete your keyfile after successfully booting.
61- Delete your keyfile after successfully booting.
62- Rejoin your favorite chat channels and subscriptions.
62- Rejoin your favorite chat channels and subscriptions.
63
63
content/using/os/ship-troubleshooting.md+1−1
@@ -38,7 +38,7 @@ When you first start your ship, you should make sure you put it a place where yo
38
38
39### Keep up-to-date builds
39### Keep up-to-date builds
40
40
41−Check for latest Urbit version at https://github.com/urbit/urbit/releases. If you're behind, update using [this guide](@/getting-started/_index.md#updating).
41+Check for latest Urbit version at https://github.com/urbit/urbit/releases. If you're behind, update using [this guide](@/getting-started/cli.md#updating).
42
42
43### `|hi` your star to see if you're connected
43### `|hi` your star to see if you're connected
44
44
templates/page_indiced.html+2−2
@@ -46,9 +46,9 @@
46 <span class="gray3"> / </span>
46 <span class="gray3"> / </span>
47 <a href="/{{ page.components[0] }}{% if page.components[2] %}/{{ page.components[1] }}{% endif %}">
47 <a href="/{{ page.components[0] }}{% if page.components[2] %}/{{ page.components[1] }}{% endif %}">
48 {% if page.components[2] %}
48 {% if page.components[2] %}
49− {{ page.components[1] | capitalize }}
49+ {{ page.components[1] | replace(from="-", to=" ") | title }}
50 {% else %}
50 {% else %}
51− {{ page.components[0] | capitalize }}
51+ {{ page.components[0] | replace(from="-", to=" ") | title }}
52 {% endif %}
52 {% endif %}
53 </a>
53 </a>
54
54