git.iko.soy/urbit.org
on master help sign in
instruction on how to boot your ship (#245)
43fcb4apoprox
content/using/install.md+54
compare with master
unifiedsplit
@@ -74,3 +74,57 @@ If you're running Urbit in the cloud on a small instance, you may need to additi
74Urbit wants to map 2GB of memory when it boots up. It won’t necessarily use all this memory, it just wants to see it. On a normal modern PC or Mac, or on a large cloud virtual machine, this is not an issue. On some small cloud virtual machines (Amazon or Digital Ocean) the default memory configuration is smaller than this, and you need to manually configure a swapfile.
74Urbit wants to map 2GB of memory when it boots up. It won’t necessarily use all this memory, it just wants to see it. On a normal modern PC or Mac, or on a large cloud virtual machine, this is not an issue. On some small cloud virtual machines (Amazon or Digital Ocean) the default memory configuration is smaller than this, and you need to manually configure a swapfile.
75
75
76Digital Ocean has a post on adding swap [here](https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-16-04). For Amazon there’s a StackOverflow thread [here](https://stackoverflow.com/questions/17173972/how-do-you-add-swap-to-an-ec2-instance).
76Digital Ocean has a post on adding swap [here](https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-16-04). For Amazon there’s a StackOverflow thread [here](https://stackoverflow.com/questions/17173972/how-do-you-add-swap-to-an-ec2-instance).
77+
78+## Booting your ship
79+
80+Now the rubber meets the road. You'll be booting your ship with the keyfile that you [downloaded from Bridge](@/using/operations/using-bridge.md).
81+
82+Note that this section is only for booting a ship that uses the live Arvo network. If you just want to create an unnetworked ship for development purposes, read [this guide](@/using/develop.md#creating-a-development-ship) instead.
83+
84+### Step 1: Find Your Urbit ID
85+
86+This will look something like `~lodleb-ritrul`. You can see the name of your Urbit ID when you log into your wallet using the Bridge client.
87+
88+### Step 2: Find the path to your keyfile
89+
90+Find the absolute path to the keyfile that you downloaded from Bridge. Copy it.
91+
92+### Step 3: Run the boot command
93+
94+Type `cd` in your terminal to return to your home directory. If you want to store your ship somewhere besides your home directory, change the terminal's working directory to the desired directory.
95+
96+Run the command below, except with `sampel-palnet` replaced by the name of your
97+Urbit identity, and `path/to/my-planet.key` replaced with the path to your keyfile:
98+
99+```
100+./urbit -w sampel-palnet -k path/to/my-planet.key
101+```
102+
103+Or, if you'd prefer to copy your key in, you can run:
104+
105+```
106+./urbit -w sampel-palnet -G rAnDoMkEy
107+```
108+
109+Either command will create a directory called `sampel-palnet/` and begin building your ship. It may take a few minutes.
110+
111+When your ship is finished booting, you will see the `~sampel-palnet:dojo>` prompt. At that point, you should permanently erase your keyfile from your machine.
112+
113+## The Dojo
114+
115+Welcome to your ship! Let's try our first command in the Dojo, the Arvo command line and Hoon REPL, to get oriented.
116+
117+Type `(add 2 2)` into the Dojo. You should see the following:
118+
119+```
120+~sampel-palnet:dojo> (add 2 2)
121+```
122+
123+When you press Enter, you should see this:
124+
125+```
126+> (add 2 2)
127+4
128+```
129+
130+Good, your Dojo is working correctly.