@@ -14,7 +14,7 @@ This guide is broken into five parts:
14+ [Basic Operations](#operation)
14+ [Basic Operations](#operation)
16_If you just want to install the Urbit OS, Arvo, and don't need to be on the
16_If you just want to install the Urbit OS, Arvo, and don't need to be on the
17−Urbit network, you can skip to [Installing Arvo](#arvo)._
17+network, you can skip to [Installing Arvo](#arvo)._
@@ -24,8 +24,9 @@ Urbit network, you can skip to [Installing Arvo](#arvo)._
25Urbit's identity layer, called Azimuth, is a suite of contracts on the Ethereum
25Urbit's identity layer, called Azimuth, is a suite of contracts on the Ethereum
26blockchain. An Azimuth address, called a *point*, functions as an identity and
26blockchain. An Azimuth address, called a *point*, functions as an identity and
27−a network address for Arvo, the Urbit OS. An instance of Arvo is called a
27+a network address for Arvo, the Urbit operating system. An instance of Arvo is
28−*ship*. A ship can't use the Arvo network until it's combined with a point.
28+called a *ship*. A ship can't use the Arvo network until it's combined with a
30Throughout this guide, we'll refer to \"Urbit identities\" and \"points\"
31Throughout this guide, we'll refer to \"Urbit identities\" and \"points\"
31interchangeably.
32interchangeably.
@@ -34,28 +35,26 @@ Points are generally not freely available, so you will need to either
34purchase one or get one from a friend. This guide assumes you have found a way
35purchase one or get one from a friend. This guide assumes you have found a way
35to acquire a point.
36to acquire a point.
37−To get Urbit address space, you'll need two things: an Ethereum address and a
38+To get an Urbit identity, you'll need two things: an Ethereum address and a
38−person willing to send you the Urbit address space.
39+person willing to send you the identity.
40You'll probably want to start with a planet. Those are cheap identities for
41You'll probably want to start with a planet. Those are cheap identities for
41−everyday use. Find someone who is willing to part with a point: a friend or a
42+everyday use. Find someone who is willing to part with a point: a friend, or a
42−stranger selling address space via smart contract. Once they've sent the address
43+stranger selling a point via smart contract. Once they've sent the point, you
43−space, you can access it using our Bridge software, or any other interface for
44+can access it using our Bridge software.
44−the Ethereum blockchain. Make sure they send you the name of the point, which
45−looks something like `~lodleb-ritrul`.
47If you bought address space from Tlon, then you should have have received a .zip
46If you bought address space from Tlon, then you should have have received a .zip
48−file that contains an Ethereum address and cryptographic secrets in
47+file that contains an Ethereum address and cryptographic secrets on a PDF. Your
49−the form of a PDF.
48+ownership PDF contains two secrets that must be kept safe:
51−Your ownership PDF contains two secrets that must be kept safe.
53−- *Master Ticket*: This is a master key that allows you to manage every aspect of
50+- *Master Ticket*: This is a master key that allows you to manage every aspect
54− your address.
51+ of your address.
56- *Ownership Seed BIP39 Mnemonic*: The master ticket encoded as a BIP39 mnemonic
53- *Ownership Seed BIP39 Mnemonic*: The master ticket encoded as a BIP39 mnemonic
57− for compatibility with most Ethereum wallet software, including our own *Bridge*
54+ for compatibility with most Ethereum wallet software, including our own
58− client.
55+ *Bridge* client.
@@ -63,14 +62,13 @@ Your ownership PDF contains two secrets that must be kept safe.
66−Bridge is client that we built for accessing and managing your Urbit identities.
65+Bridge is a client that we built for accessing and managing your Urbit
67−Like Wallet Generator, Bridge comes in the form of an offline HTML application
66+identities. Bridge comes in the form of an offline HTML application that can be
68−that can be run in Firefox on all platforms, and also in Chrome if you're using
67+run in Firefox, Safari, or Chrome.
71Importantly, Bridge also automates the process of generating the keyfile that
69Importantly, Bridge also automates the process of generating the keyfile that
72you will need a single time to boot your ship on the Arvo network. Once a ship
70you will need a single time to boot your ship on the Arvo network. Once a ship
73−is booted, it isn't booted again. It stays booted forever.
71+is booted, it stays booted forever.
75Download bridge [here](https://github.com/urbit/bridge/releases) and follow
73Download bridge [here](https://github.com/urbit/bridge/releases) and follow
76the instructions below.
74the instructions below.
@@ -276,7 +274,7 @@ that you downloaded from bridge.
276This will look something like `~lodleb-ritrul`. You can see the name of your
274This will look something like `~lodleb-ritrul`. You can see the name of your
277point(s) when you log into your wallet using the Bridge client.
275point(s) when you log into your wallet using the Bridge client.
279−;img@"media.urbit.org/site/bridge-0.png"(width "100%");
277+;img@"http://media.urbit.org/site/bridge-0.png"(width "100%");
281#### Step 2: Find the path to your keyfile
279#### Step 2: Find the path to your keyfile
@@ -377,27 +375,25 @@ $ urbit some-planet
378Your ship is also accessible through its own web interface. Through the web
376Your ship is also accessible through its own web interface. Through the web
379interface you'll have access to our chat and message boards, the two components
377interface you'll have access to our chat and message boards, the two components
380−of our _Landscape_ feature. This is a user-friendly way to chat with Talk on the
378+of our _Landscape_ feature. This is a user-friendly way to use Talk on the
381Arvo network and access and materials you've published on your ship. If You're
379Arvo network and access and materials you've published on your ship. If You're
382running Arvo locally on your own machine, try opening `http://localhost/` in
380running Arvo locally on your own machine, try opening `http://localhost/` in
383your browser.
381your browser.
385−Or if you're running your ship on a cloud instance with a static IP address
383+Or, if you're running your ship on a cloud instance with a static IP address
386−(which we recommend!), something like 212.131.240.20, assuming you've opened up
384+(which we recommend!), something like 212.131.240.20,
387−the HTTP port that Arvo uses -- the default is port 80. So
388−`http://212.131.240.20:80/~~/` would go into your browser's URL bar.
385+`http://212.131.240.20:80/~~/` would go into your browser's URL bar. This way,
390−This way, if you keep your ship running securely in the cloud (usually in a
386+if you keep your ship running securely in the cloud (usually in a screen or tmux
391−screen or tmux session), you can always access your ships's web interface in any
387+session), you can always access your ships's web interface in any browser on
392−browser on any device, so long as you have your password on hand.
388+any device.
394The `/~~/` in the URL will redirect you to a login page, which was generated by
390The `/~~/` in the URL will redirect you to a login page, which was generated by
395−Tree, the basic Arvo web interface. The page will tell you to run the +code
391+Tree, the basic Arvo web interface. The page will tell you to run the `+code`
396−generator (an Arvo shell script) in your Dojo to get your password. Copy and
392+generator (an Arvo shell-script) in your Dojo to get your password. Copy and
397−paste that into your password input box and hit Enter. After loading, you'll
393+paste that into the password-input field and hit Enter. After loading, you'll
398find yourself redirected to your home page, authenticated, where you can then
394find yourself redirected to your home page, authenticated, where you can then
399use the navigation bar at the top of the page to visit your Talk web interface
395use the navigation bar at the top of the page to visit your Talk web interface
400and static files.
396and static files.
402When you use the web interface, your urbit is automatically subscribed to
398When you use the web interface, your urbit is automatically subscribed to
403−`/urbit-meta` and Fora, our message-board system.
399+`/urbit-meta` and our message-board system, Posts.