fb5c44a · urbit.org · git.iko.soy

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

237

238When 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.

239

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.

241

242### Will the Urbit OS network survive if Ethereum dies? {#if-ethereum-dies}

243

@@ -245,11 +245,11 @@ Yes. It would be annoying, but Urbit ID / [Azimuth](@/docs/glossary/azimuth.md)

245

246### How do I install Urbit OS? {#install-urbit-os}

247

248−Check out our guides [here](@/using/install.md).

248+Check out our guides [here](@/using/planet.md).

249

250### How do I use Urbit OS? {#use-urbit-os}

251

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.

253

254### How do over-the-air updates work? {#over-the-air-updates}

255

@@ -261,7 +261,7 @@ Your sponsor, a star or galaxy that your ship is connected to, may send you new

261

262### I have an Urbit ID, now what? {#now-what}

263

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).

265

266Get on the [mailing list](https://urbit.us11.list-manage.com/subscribe/post?u=972a03db9e0c6c25bb58de8c8&id=be143888d2). Learn [Hoon](@/docs/tutorials/hoon/hoon-school/_index.md). Sign up for [Hooniversity](https://hooniversity.org/). [Make stuff](https://grants.urbit.org).

267

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

771. Download your [keyfile from Bridge](https://urbit.org/using/install/#keyfile).

782. Shut down your ship.

793. [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.

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/install/#boot-your-planet).

81+5. [Boot your ship with the new keyfile](https://urbit.org/using/running/install/#boot-your-planet).

82

83## I’m hosted by Tlon, or someone else—what do I need to do?

84

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,

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.

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](@/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.

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/).)

49

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

18

19We assume you’ve gotten a basic introduction to Urbit. If you haven’t, read the [Understanding Urbit](@/understanding-urbit/_index.md) series.

20

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).

22

23When 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.

24

@@ -104,7 +104,7 @@ Stars and galaxies, however, have additional responsibilities and play a role in

104

105Running a reliable galaxy or star, and spawning stars and planets from them, are excellent ways to help bootstrap the Urbit network.

106

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).

108

109If you’re interested in distributing planets, read on.

110

@@ -114,4 +114,4 @@ Want to get your friends and family into Urbit? Distribute planets using Bridge

114

115Here’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.

116

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

14

15To 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.

16

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).

18

19### Local Bridge

20

@@ -72,7 +72,7 @@ It should be noted that setting your network keys is an event on the Ethereum ne

72From 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.

73Click `Generate ->`, which will download a keyfile onto your machine.

74

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).

76

77### Escaping your sponsor

78

content/using/operations/using-your-ship.md+2−3

@@ -3,7 +3,6 @@ title = "Using Your Ship"

3description = "How to operate your ship, including using your ship's filesystem and messaging applications, starting a moon, or requesting a DNS proxy."

4template = "page_indiced.html"

5weight = 2

6−aliases = ["docs/using/arvo-network-dns/", "docs/using/messaging/", "docs/using/shell/", "docs/using/admin/"]

7[extra]

6[extra]

8hidetitle = "true"

7hidetitle = "true"

9+++

8+++

@@ -155,7 +154,7 @@ in this example.

155

154

156Put `<key>` in a file and that file becomes `<keyfile>`.

155Put `<key>` in a file and that file becomes `<keyfile>`.

157

156

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:

159

158

160```sh

159```sh

161$ ./urbit -w <moonname> -G <key> -c <piername>

160$ ./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

203or galaxy, respectively. If your sponsor isn't suiting your needs, you can

202or galaxy, respectively. If your sponsor isn't suiting your needs, you can

204escape to a different one. This can be done with

203escape to a different one. This can be done with

205[Bridge](https://bridge.urbit.org/) following the instructions

204[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).

207

206

208### Continuity breaches

207### Continuity breaches

209

208

content/using/os/stars-and-galaxies.md+3−3

@@ -6,7 +6,7 @@ aliases = ["/docs/using/operating-a-star/"]

6template = "page_indiced.html"

7+++

8

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).

10

11### Hosting your star

12

@@ -14,7 +14,7 @@ If you plan to distribute planets in any capacity, we ask that you keep your sta

14running. If you fail to do so, those planets will become orphans that are unable

15to communicate with the network unless they transfer to a new star.

16

17−See our [cloud hosting instructions](@/using/operations/hosting.md) for

17+See our [cloud hosting instructions](@/using/running/hosting.md) for

18instructions on settings up a Digital Ocean droplet.

19

20### Distributing planets

@@ -27,7 +27,7 @@ By default, your star accepts software updates from its galaxy and routes them t

27

28#### Breaches

29

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.

31

32Network-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.

33

content/using/os/using-your-ship.md+3−3

@@ -3,7 +3,7 @@ title = "Using Your Ship"

3description = "How to operate your ship, including using your ship's filesystem and messaging applications, starting a moon, or requesting a DNS proxy."

4template = "page_indiced.html"

5weight = 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/"]

7[extra]

8hidetitle = "true"

9+++

@@ -155,7 +155,7 @@ in this example.

155

156Put `<key>` in a file and that file becomes `<keyfile>`.

157

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:

159

160```sh

161$ ./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

203or galaxy, respectively. If your sponsor isn't suiting your needs, you can

204escape to a different one. This can be done with

205[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).

207

208### Continuity breaches

209

content/using/planet.md+4−4

@@ -5,7 +5,7 @@ description = "Getting started with a permanent Urbit identity."

5template = "page_indiced.html"

6+++

7

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.

9

10### Purchase a planet {#purchase}

11

@@ -35,7 +35,7 @@ Current hosting providers are:

35

36Urbit 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!

37

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.

39

40### Get your keyfile {#keyfile}

41

@@ -124,6 +124,6 @@ If for some reason your sponsor (in this case, `~dopzod`) is not responding, rea

124

125Now that you’re up and running, take some time to deepen your understanding by checking out some of our other guides:

126

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.

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/operations/using-your-ship.md): Become an expert pilot by learning to use your ship.

128+- [Read the Operations Manual](@/using/os/using-your-ship.md): Become an expert pilot by learning to use your ship.

129- [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.

104 ```

105

106## 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.

108 - **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.

109 - The first thing you're going to want to do is shut down your local ship, either with control-d or `|exit` in dojo.

110 - 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

167 - [Digital Ocean Nginx Installation][DO Nginx Install]

168 - [Digital Ocean Nginx Config][DO Nginx Config]

169 - [Digital Ocean SSL Cert Setup][DO SSL Config]

170− - [Urbit Install Docs](@/using/install.md)

170+ - [Urbit Install Docs](@/using/running/install.md)

171 - [Urbit Basic Cloud Install][Urbit Basic Cloud Install]

172

173 [Gandi]: https://www.gandi.net/