on master help sign in
restructure and revise getting-started
commitb0a52cc4b6f449d5df6c6e0182491422af3d9992 authortinnus-napbus <admin@tinnus-napbus.xyz> dateThu 7 Oct 2021, 19:54 (5 years ago) parent28223fb
1 file changed+35−6
content/getting-started/_index.md+35−6
content/getting-started/_index.md+35−6
@@ -6,11 +6,40 @@ page_template = "page_indiced.html"
66template = "getting-started/index.html"
77+++
88
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.
9+If you want to jump right in and try out Urbit with a free, disposible ID called a **Comet**, you can download the desktop client [**Port**](#get-port). Once installed, start it up and hit the `Start without an ID` button. It'll take a few minutes to spin up the new Comet, then click `Launch Ship into Urbit` and you'll be at the login screen. Click on `Copy Access Key` at the bottom-left, paste it into the `Access Key` field, and hit `Continue`. You'll now be at your ship's home screen and ready to explore Urbit. You can also have a look at the [Next Steps](#next-steps) section below to help you get going.
1010
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#hosting-providers), though Windows instructions are provided [for power users](/getting-started/cli).
11+If want to get a permanent Urbit ID called a **Planet**, have a look at the [Get a planet](#get-a-planet) section below.
1212
13−### Get Port {#port}
13+If you have a **Planet** and want some help getting it up and running the first time, see the [Setting up your urbit](#setting-up-your-urbit) guide.
14+
15+If you want to use a **Planet** without worrying about the gritty bits, you may want to consider a [hosting provider](#hosting-providers).
16+
17+If you're technically proficient and would like greater control over the Urbit virtual machine than is possible with [Port](#get-port), or are setting up Urbit on a cloud droplet, try [installation using the command line](/getting-started/cli).
18+
19+## Get a planet
20+
21+There are a few ways to get your own planet:
22+
23+- Getting an invitation from a friend (or stranger).
24+- Purchasing a planet, including hosting, from a [hosting provider](#hosting-providers).
25+- Manually setting up and hosting a planet purchased from a third party such as [urbit.live](https://urbit.live), [OpenSea](https://opensea.io), [planet.market](https://planet.market/), [urbit.me](https://urbit.me), [urth systems](https://urth.systems/), or [Urbit Marketplace](https://urbitmarketplace.com/).
26+
27+## Hosting Providers {#hosting-providers}
28+
29+Hosting providers will often sell you a planet and run it for you. This option is very simple but will probably cost a regular fee.
30+
31+Urbit is designed to be portable. This means that if you sign up for hosting now but later want to leave your hosting provider and run your Urbit yourself, you should be able to work with them to obtain all of your data and boot your planet back up without losing anything.
32+
33+Using hosting does mean that you're trusting your provider with your data, but so long as you have your planet, you'll always own your identity.
34+
35+Current hosting providers are:
36+
37+- [escape pod store](https://www.escapepod.store/)
38+- [Third Earth](https://third.earth/)
39+- [Tlon Corporation](https://tlon.io)
40+- [UrbitHost](https://urbithost.com)
41+
42+## Get Port {#port}
1443
1544**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.
1645
@@ -76,11 +105,11 @@ Or to install `snap` for your distribution, snapcraft provides [installation ins
76105}
77106</style>
78107
79−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](/getting-started/cli).
108+## Next steps
80109
81−### Next steps
110+Once you've got your ship up and running, you might like to join the official Urbit Community group and say hello. Just click on the `Groups` app and it will open Urbit's communications suite. In Groups, hit `Join Group` and enter `~bitbet-bolbel/urbit-community`. Once joined, a new tile for the group will appear on the Groups home screen. Open that, click on the `General` channel in the sidebar, and hit `Join Channel`. It'll take a couple of minutes to download the chat history, then you'll be able to post a message.
82111
83−If you haven't already done so, we recommend spending 10 minutes or so reading
112+If you haven't already done so, we recommend spending a few minutes reading
84113[Understanding Urbit](/understanding-urbit) to get acquainted with the project.
85114Then once you've been become acquainted with your ship and explored the network
86115for awhile, consider checking out the [User's Manual](/using) which provides