@@ -6,209 +6,79 @@ page_template = "page_indiced.html"
66template = "getting-started/index.html"
77+++
88
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.
1010
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).
1212
13−It's easy and it keeps getting easier.
13+### Get Port {#port}
1414
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.
1616
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">
26− <input type="radio" id="macos" name="os" checked>
27− <label for="macos">MacOS</label>
17+<div id="port-os" class="os mv3">
18+ <input type="radio" id="port-macos" name="port-os" checked>
19+ <label for="port-macos">MacOS</label>
2820 <div class="tab">
29−
30−```sh
31−mkdir ~/urbit
32−cd ~/urbit
33−curl -JLO https://urbit.org/install/mac/latest
34−tar zxvf ./darwin.tgz --strip=1
35−~/urbit/urbit
36−```
21+ <p>To install <strong>Port</strong> on MacOS simply download and open the <code>.dmg</code> file.</p>
22+ <a href="https://github.com/arthyn/taisho/releases/latest/download/taisho.dmg" class="dib ph3 ba b--gray3 br2">
23+ Download Port
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>
25+ </a>
3726 </div>
3827
39− <input type="radio" id="linux" name="os">
40− <label for="linux">Linux</label>
28+ <input type="radio" id="port-linux" name="port-os">
29+ <label for="port-linux">Linux</label>
4130 <div class="tab">
4231
43−```sh
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:
32+We use `snap` so that **Port** can stay updated automatically. If you already have `snap` installed, simply run:
5233
5334```sh
54−sudo apt-get install libcap2-bin
55−sudo setcap 'cap_net_bind_service=+ep' ~/urbit/urbit
35+sudo snap install port
5636```
57−</div>
58−
59− <input type="radio" id="windows" name="os">
60− <label for="windows">Windows</label>
61− <div class="tab">
6237
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).
6439
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>
6941</div>
7042
7143<style>
72− #os {
44+ .os {
7345 display: flex;
7446 flex-wrap: wrap;
7547 }
76− #os label {
48+ .os label {
7749 order: -1;
7850 padding: .5rem;
51+ min-width: 70px;
52+ text-align: center;
7953 border-width: 1px 0px 0px 1px;
8054 border-style: solid;
8155 cursor: pointer;
8256 }
83− #os label[for=windows] {
57+ .os label:last-of-type {
8458 border-right-width: 1px;
8559 }
86− #os input[type="radio"] {
60+ .os input[type="radio"] {
8761 display: none;
8862 }
89− #os .tab {
63+ .os .tab {
9064 display: none;
9165 border: 1px solid;
9266 padding: 1rem;
67+ width: 100%;
9368 max-width: 100%;
9469 }
95− #os input[type='radio']:checked + label {
70+ .os .tab p:first-child {
71+ margin-top: 0;
72+ }
73+ .os .tab p:last-child {
74+ margin-bottom: 0;
75+ }
76+ .os input[type='radio']:checked + label {
9677 font-weight: bold;
9778 }
98− #os input[type='radio']:checked + label + .tab {
79+ .os input[type='radio']:checked + label + .tab {
9980 display: block;
10081}
10182</style>
10283
103−If successful, you will see a block of output beginning with the line:
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).
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).