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). Changes to these files are automatically synced into your ship.
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: