Booting a Ship
Now the rubber meets the road. You'll be booting your ship with the keyfile that you downloaded from Bridge.
Note that this document 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 instead.
Step 1: Find Your Point's Name
This will look something like
~lodleb-ritrul. You can see the name of your point(s) when you log into your wallet using the Bridge client.
Step 2: Find the path to your keyfile
Find the absolute path to the keyfile that you downloaded from Bridge. Copy it.
Step 3: Run the boot command
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.
Run the command below, except with
sample-planet replaced by the name of your
Urbit identity, and
path/to/my-planet.key replaced with the path to your
./urbit -w sample-planet -k path/to/my-planet.key
Or, if you'd prefer to copy your key in, you can run:
./urbit -w sample-planet -G rAnDoMkEy
Either command will create a directory called
sample-planet/ and begin
building your ship. It may take a few minutes.
When your ship is finished booting, you will see the
prompt. At that point, you should permanently erase your keyfile from your
Welcome to your ship! There's a few things you should do to become oriented.
Let's try out the Dojo, the Arvo command line and Hoon REPL:
~sample-planet:dojo> (add 2 2)
> (add 2 2) 4
Your ship's filesystem being "mounted" means that its filesystem can be interacted with through Unix. This makes things much easier for you.
The Arvo filesystem isn't mounted to Unix by default. Switch to the Dojo prompt and run:
~sample-planet:dojo> |mount %
This should produce:
> |mount % >=
which indicates that the command was processed.
|mount % will cause a
home/ directory to appear inside your pier folder in Unix (the "pier" is our shorthand for the directory whose name corresponds to your Azimuth point). Once you've changed a file,
|commit %home to synchronize changes to your pier.
Note: Do not delete your pier. Doing so will make your ship unusable, because deleted piers normally cannot be recovered. The exception is during a network breach (a reset) -- in such a rare event, you must delete your pier to update your ship to the new era, and ships with previously deleted piers can be recovered.
Shutting Down and Restarting
You can toggle between the Dojo and Talk (chat) prompts with
ctrl-x. You can turn your ship off with
ctrl-d from the Talk or Dojo prompts.
To restart your ship, simply pass the name of your pier:
Landscape is the Urbit web interface, and it's the best way to interact with your ship. Chrome and Brave are the recommended browsers for using Landscape. To get onto Landscape:
- Start your ship. In the boot messages, look for a line that says something like
http: live (insecure, public) on 80. The number given is the port that your ship is using.
- If the port given is 80, simply type
localhostinto your browser's address bar. If the given port is a different number, such as
8080, you would type
+codeinto your ship's Dojo. Copy-paste the returned code into the field asking for it.
- You're in! Now you can explore apps such as Chat for messages, Publish for blogging, and Weather.