git.iko.soy/urbit.org
on master help sign in
update links for reorg
commitfb5c44a2dd19824e6b53f331414ea951ac9e3530 authorDavid Kerschner <dkerschner@hcoop.net> dateMon 1 Mar 2021, 15:10 (6 years ago) parent341aed5
11 files changed+26−31
compare with master
unifiedsplit
content/faq.md+4−4 content/media.md−4 content/reset.md+2−2 content/understanding-urbit/interface.md+1−1 content/using/develop.md+3−3 content/using/id/using-bridge.md+2−2 content/using/operations/using-your-ship.md+2−3 content/using/os/stars-and-galaxies.md+3−3 content/using/os/using-your-ship.md+3−3 content/using/planet.md+4−4 content/using/running/hosting.md+2−2
content/faq.md+4−4
@@ -237,7 +237,7 @@ All events are logged to disk, so you can always restore the system to a previou
237237
238238When an [Arvo](@/docs/glossary/arvo.md) ship (instance) is started for the first time you must use a "[keyfile](@/docs/glossary/keyfile.md)" containing the private keys for your identity's networking keys. Urbit ID uses the Ethereum blockchain as its decentralized ledger.
239239
240−See our [Getting Started](@/using/install.md) guide to learn how to get your ship onto the Urbit OS / [Ames](@/docs/glossary/ames.md) network.
240+See our [Getting Started](@/using/planet.md) guide to learn how to get your ship onto the Urbit OS / [Ames](@/docs/glossary/ames.md) network.
241241
242242### Will the Urbit OS network survive if Ethereum dies? {#if-ethereum-dies}
243243
@@ -245,11 +245,11 @@ Yes. It would be annoying, but Urbit ID / [Azimuth](@/docs/glossary/azimuth.md)
245245
246246### How do I install Urbit OS? {#install-urbit-os}
247247
248−Check out our guides [here](@/using/install.md).
248+Check out our guides [here](@/using/planet.md).
249249
250250### How do I use Urbit OS? {#use-urbit-os}
251251
252−The [Using](@/using/operations/_index.md) section of the documentation will help you out.
252+The [Using](@/using/os/using-your-ship.md) section of the documentation will help you out.
253253
254254### How do over-the-air updates work? {#over-the-air-updates}
255255
@@ -261,7 +261,7 @@ Your sponsor, a star or galaxy that your ship is connected to, may send you new
261261
262262### I have an Urbit ID, now what? {#now-what}
263263
264−Follow our guide on how to boot a ship [here](@/using/install.md).
264+Follow our guide on how to boot a ship [here](@/using/planet.md).
265265
266266Get on the [mailing list](https://urbit.us11.list-manage.com/subscribe/post?u=972a03db9e0c6c25bb58de8c8&amp;id=be143888d2). Learn [Hoon](@/docs/tutorials/hoon/hoon-school/_index.md). Sign up for [Hooniversity](https://hooniversity.org/). [Make stuff](https://grants.urbit.org).
267267
content/media.mddeleted−4
@@ -1,4 +0,0 @@
1−+++
2−title = "Media"
3−template = "media/list.html"
4−+++
content/reset.md+2−2
@@ -77,8 +77,8 @@ Yes, by following these steps (note that these steps **will not** back up your d
77771. Download your [keyfile from Bridge](https://urbit.org/using/install/#keyfile).
78782. Shut down your ship.
79793. [Archive and move your old pier](https://urbit.org/using/operations/using-your-ship/#moving-your-pier) (this is the directory that contains your urbit event log).
80−4. [Download the latest version](@/using/install.md#macos-and-linux) of the urbit binary.
81−5. [Boot your ship with the new keyfile](https://urbit.org/using/install/#boot-your-planet).
80+4. [Download the latest version](@/using/running/install.md#macos-and-linux) of the urbit binary.
81+5. [Boot your ship with the new keyfile](https://urbit.org/using/running/install/#boot-your-planet).
8282
8383## I’m hosted by Tlon, or someone else—what do I need to do?
8484
content/understanding-urbit/interface.md+1−1
@@ -43,7 +43,7 @@ OS 1 is a minimal, multipurpose interface for bringing a group together to chat,
4343
4444We 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.
4545
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](@/using/install.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](@/using/running/install.md#comet) to come talk to us.
4747
4848(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/).)
4949
content/using/develop.md+3−3
@@ -18,7 +18,7 @@ This guide will start by getting you set up to run an Urbit ship, and then tell
1818
1919We assume you’ve gotten a basic introduction to Urbit. If you haven’t, read the [Understanding Urbit](@/understanding-urbit/_index.md) series.
2020
21−Once you’re ready, you can get started on the network right away and take some first steps, without acquiring an identity, by [creating a comet](@/using/install.md#comet).
21+Once you’re ready, you can get started on the network right away and take some first steps, without acquiring an identity, by [creating a comet](@/using/running/install.md#comet).
2222
2323When developing, however, we recommend [booting a development ship](#creating-a-development-ship) and working locally -- you may need to make changes that could, in the wrong hands, destroy the ship’s environment, and it’s best to do so in a safe, separate place.
2424
@@ -104,7 +104,7 @@ Stars and galaxies, however, have additional responsibilities and play a role in
104104
105105Running a reliable galaxy or star, and spawning stars and planets from them, are excellent ways to help bootstrap the Urbit network.
106106
107−If you’re interested in running a galaxy or star, you’ll be reliably providing peer discovery for your children just by running your node – and we’re doing our best to make this both easy and profitable. If you’re interested in this, see [Star and Galaxy Operations](@/using/operations/stars-and-galaxies.md).
107+If you’re interested in running a galaxy or star, you’ll be reliably providing peer discovery for your children just by running your node – and we’re doing our best to make this both easy and profitable. If you’re interested in this, see [Star and Galaxy Operations](@/using/os/stars-and-galaxies.md).
108108
109109If you’re interested in distributing planets, read on.
110110
@@ -114,4 +114,4 @@ Want to get your friends and family into Urbit? Distribute planets using Bridge
114114
115115Here’s how it works: any star can grant a number of invites to any of its child planets. Those planets can then send one-time-use invite codes via email to anyone of their choosing.
116116
117−For instructions on how to grant and send invites, check out [Using Bridge](@/using/operations/using-bridge.md).
117+For instructions on how to grant and send invites, check out [Using Bridge](@/using/id/using-bridge.md).
content/using/id/using-bridge.md+2−2
@@ -14,7 +14,7 @@ This guide assumes that you have an Urbit ID, or that you have found someone to
1414
1515To connect to Bridge, go to [https://bridge.urbit.org](https://bridge.urbit.org) into your browser, and enter your identity's credentials in the appropriate fields. If you were invited to claim an Urbit ID, it's very likely that you received an email that would direct you to Bridge, and you can simply follow the hyperlink in that email.
1616
17−You'll arrive at a page and see two major choices: `ID` and `OS`. `OS` is the only option that you're interested in right now; click on it. On the `OS` page, click the `Download Arvo Keyfile` button. Once you have downloaded the keyfile, you can exit Bridge and proceed to [install the Urbit binary](@/using/install.md).
17+You'll arrive at a page and see two major choices: `ID` and `OS`. `OS` is the only option that you're interested in right now; click on it. On the `OS` page, click the `Download Arvo Keyfile` button. Once you have downloaded the keyfile, you can exit Bridge and proceed to [install the Urbit binary](@/using/running/install.md).
1818
1919### Local Bridge
2020
@@ -72,7 +72,7 @@ It should be noted that setting your network keys is an event on the Ethereum ne
7272From the detail page associated with your point, click the `Generate Arvo Keyfile` link and you'll be taken to a page with a field titled `Network seed`. This field should already be filled in, and should match the hexadecimal string that you entered in the previous step. If it's not filled in or does not match, fill it in with the correct string.
7373Click `Generate ->`, which will download a keyfile onto your machine.
7474
75−With that keyfile in hand, you can now exit Bridge and continue to the guide to [install the Urbit binary](@/using/install.md).
75+With that keyfile in hand, you can now exit Bridge and continue to the guide to [install the Urbit binary](@/using/running/install.md).
7676
7777### Escaping your sponsor
7878
content/using/operations/using-your-ship.md+2−3
@@ -3,7 +3,6 @@ title = "Using Your Ship"
33description = "How to operate your ship, including using your ship's filesystem and messaging applications, starting a moon, or requesting a DNS proxy."
44template = "page_indiced.html"
55weight = 2
6−aliases = ["docs/using/arvo-network-dns/", "docs/using/messaging/", "docs/using/shell/", "docs/using/admin/"]
76[extra]
87hidetitle = "true"
98+++
@@ -155,7 +154,7 @@ in this example.
155154
156155Put `<key>` in a file and that file becomes `<keyfile>`.
157156
158−You can use the resulting output in the same installation flow from the [Installing Urbit](@/using/install.md) guide, following the same scheme as for booting a planet. That scheme is:
157+You can use the resulting output in the same installation flow from the [Installing Urbit](@/using/running/install.md) guide, following the same scheme as for booting a planet. That scheme is:
159158
160159```sh
161160$ ./urbit -w <moonname> -G <key> -c <piername>
@@ -203,7 +202,7 @@ To use the network as a planet or star, you must be sponsored by an active star
203202or galaxy, respectively. If your sponsor isn't suiting your needs, you can
204203escape to a different one. This can be done with
205204[Bridge](https://bridge.urbit.org/) following the instructions
206−[here](@/using/operations/using-bridge.md#escaping-your-sponsor).
205+[here](@/using/id/using-bridge.md#escaping-your-sponsor).
207206
208207### Continuity breaches
209208
content/using/os/stars-and-galaxies.md+3−3
@@ -6,7 +6,7 @@ aliases = ["/docs/using/operating-a-star/"]
66template = "page_indiced.html"
77+++
88
9−To boot your galaxy or star, follow our [installation instructions](@/using/install.md).
9+To boot your galaxy or star, follow our [installation instructions](@/using/running/install.md).
1010
1111### Hosting your star
1212
@@ -14,7 +14,7 @@ If you plan to distribute planets in any capacity, we ask that you keep your sta
1414running. If you fail to do so, those planets will become orphans that are unable
1515to communicate with the network unless they transfer to a new star.
1616
17−See our [cloud hosting instructions](@/using/operations/hosting.md) for
17+See our [cloud hosting instructions](@/using/running/hosting.md) for
1818instructions on settings up a Digital Ocean droplet.
1919
2020### Distributing planets
@@ -27,7 +27,7 @@ By default, your star accepts software updates from its galaxy and routes them t
2727
2828#### Breaches
2929
30−To ensure new planets can connect to your ship, users are expected to participate in network-wide breaches by [updating to the latest Urbit version](@/using/install.md), deleting (or archiving) your pier, and then booting your ship using the new binary. If you don’t participate, you won’t be able to communicate with anyone on the network who has updated to the new era.
30+To ensure new planets can connect to your ship, users are expected to participate in network-wide breaches by [updating to the latest Urbit version](@/using/running/install.md), deleting (or archiving) your pier, and then booting your ship using the new binary. If you don’t participate, you won’t be able to communicate with anyone on the network who has updated to the new era.
3131
3232Network-wide breaches are distinct from personal breaches, wherein an individual ship cycles its personal network keys using Bridge, and then follows the same steps outlined above.
3333
content/using/os/using-your-ship.md+3−3
@@ -3,7 +3,7 @@ title = "Using Your Ship"
33description = "How to operate your ship, including using your ship's filesystem and messaging applications, starting a moon, or requesting a DNS proxy."
44template = "page_indiced.html"
55weight = 2
6−aliases = ["docs/using/arvo-network-dns/", "docs/using/messaging/", "docs/using/shell/", "docs/using/admin/"]
6+aliases = ["docs/using/messaging/", "docs/using/admin/"]
77[extra]
88hidetitle = "true"
99+++
@@ -155,7 +155,7 @@ in this example.
155155
156156Put `<key>` in a file and that file becomes `<keyfile>`.
157157
158−You can use the resulting output in the same installation flow from the [Installing Urbit](@/using/install.md) guide, following the same scheme as for booting a planet. That scheme is:
158+You can use the resulting output in the same installation flow from the [Installing Urbit](@/using/running/install.md) guide, following the same scheme as for booting a planet. That scheme is:
159159
160160```sh
161161$ ./urbit -w <moonname> -G <key> -c <piername>
@@ -203,7 +203,7 @@ To use the network as a planet or star, you must be sponsored by an active star
203203or galaxy, respectively. If your sponsor isn't suiting your needs, you can
204204escape to a different one. This can be done with
205205[Bridge](https://bridge.urbit.org/) following the instructions
206−[here](@/using/operations/using-bridge.md#escaping-your-sponsor).
206+[here](@/using/id/using-bridge.md#escaping-your-sponsor).
207207
208208### Continuity breaches
209209
content/using/planet.md+4−4
@@ -5,7 +5,7 @@ description = "Getting started with a permanent Urbit identity."
55template = "page_indiced.html"
66+++
77
8−A planet is a permanent Urbit identity. Like all Urbit identities, they can never be taken away from you. Unlike comets which are free, planets are designed for use well into the future. If you're not yet familiar with the Urbit network, please follow the [Getting Started guide](/using/install), which will explain the basics and walk you through using a free identity. This guide explains the next steps.
8+A planet is a permanent Urbit identity. Like all Urbit identities, they can never be taken away from you. Unlike comets which are free, planets are designed for use well into the future. If you're not yet familiar with the Urbit network, please follow the [Getting Started guide](/using/running/install), which will explain the bafasdfsics and walk you through using a free identity. This guide explains the next steps.
99
1010### Purchase a planet {#purchase}
1111
@@ -35,7 +35,7 @@ Current hosting providers are:
3535
3636Urbit must run on an existing computer somewhere. Most users run their planet on their personal computer, but we recommend eventually using a cloud service (Digital Ocean, Linode, etc) because it allows your planet to be accessed from anywhere on multiple devices. Hosting your planet in the cloud also allows it to always be online and ready for automatic updates. You are welcome to run from your personal computer and switch to the cloud later...all without losing any data!
3737
38−There is a guide for [hosting your planet on DigitalOcean](@/using/operations/hosting.md) and [hosting your planet on Linode](https://jeremytunnell.com/2021/01/09/how-to-install-urbit-on-a-linode-vps), but any cloud hosting service should work.
38+There is a guide for [hosting your planet on DigitalOcean](@/using/running/hosting.md) and [hosting your planet on Linode](https://jeremytunnell.com/2021/01/09/how-to-install-urbit-on-a-linode-vps), but any cloud hosting service should work.
3939
4040### Get your keyfile {#keyfile}
4141
@@ -124,6 +124,6 @@ If for some reason your sponsor (in this case, `~dopzod`) is not responding, rea
124124
125125Now that you’re up and running, take some time to deepen your understanding by checking out some of our other guides:
126126
127−- [Host your Ship in the Cloud](@/using/operations/hosting.md): Follow this guide to set your ship up to run as a cloud server, accessible from anywhere.
128−- [Read the Operations Manual](@/using/operations/using-your-ship.md): Become an expert pilot by learning to use your ship.
127+- [Host your Ship in the Cloud](@/using/running/hosting.md): Follow this guide to set your ship up to run as a cloud server, accessible from anywhere.
128+- [Read the Operations Manual](@/using/os/using-your-ship.md): Become an expert pilot by learning to use your ship.
129129- [Learn to Develop on Urbit](@/using/develop.md): Learn how to contribute to or develop on Urbit.
content/using/running/hosting.md+2−2
@@ -104,7 +104,7 @@ Continuing to follow the DO docs we're going to configure the ufw firewall.
104104 ```
105105
106106## Installing Urbit
107−Finally we're ready to install Urbit on your very own server. This part is actually pretty easy, if you haven't installed Urbit locally then the instructions are the exact same as the ones in the Urbit [install doc](@/using/install.md). If you have a local ship already, we're going to install Urbit on the server and then send your local ship up.
107+Finally we're ready to install Urbit on your very own server. This part is actually pretty easy, if you haven't installed Urbit locally then the instructions are the exact same as the ones in the Urbit [install doc](@/using/running/install.md). If you have a local ship already, we're going to install Urbit on the server and then send your local ship up.
108108 - **WARN**: Since Urbit is p2p you don't want to ever run two copies of your ship simultaneously. This is because other nodes that interact with each of your copies will be confused by which one is the most up to date. If you end up accidentally doing this you'll have to do a 'personal breach' described in the [guide to breaches](@/docs/tutorials/guide-to-breaches.md) to fix things.
109109 - The first thing you're going to want to do is shut down your local ship, either with control-d or `|exit` in dojo.
110110 - Next we're going to install Urbit on the server and permit it to bind to the web ports:
@@ -167,7 +167,7 @@ On iOS you can save a website to your homescreen as an icon. If you do this for
167167 - [Digital Ocean Nginx Installation][DO Nginx Install]
168168 - [Digital Ocean Nginx Config][DO Nginx Config]
169169 - [Digital Ocean SSL Cert Setup][DO SSL Config]
170− - [Urbit Install Docs](@/using/install.md)
170+ - [Urbit Install Docs](@/using/running/install.md)
171171 - [Urbit Basic Cloud Install][Urbit Basic Cloud Install]
172172
173173 [Gandi]: https://www.gandi.net/