git.iko.soy/urbit.org
on master help sign in
Clarify and emphasise post-boot keyfile deletion

New users commonly run into problems when they try to run the initial boot command (with `-k`) for a subsequent boot - it's natural to think "this is how I started my ship the first time, and having shut it down I now want to start it again, so I'll run the same command". The existing recommendation to delete the keyfile doesn't make a note of *why* this recommendation is made, and so seems to often go ignored.

commit373c7646a17861816bcf6d4993d34459d4be748e authorlycurgus <lycurgus@users.noreply.github.com> dateFri 21 Aug 2020, 08:22 (6 years ago) parent23cf79e
1 file changed+3−1
compare with master
unifiedsplit
content/using/install.md+3−1
content/using/install.md+3−1
@@ -368,7 +368,9 @@ Or, if you'd prefer to copy your key in, you can run:
368368
369369Either command will create a directory called `sampel-palnet/` and begin building your ship. It may take a few minutes.
370370
371−When your ship is finished booting, you will see either the `~sampel-palnet:dojo>` or `~sampel-palnet:chat-cli/` prompt. If you're seeing `:chat-cli` press `Ctrl-x` to switch into Dojo. At that point, you should permanently erase your keyfile from your machine.
371+When your ship is finished booting, you will see either the `~sampel-palnet:dojo>` or `~sampel-palnet:chat-cli/` prompt. If you're seeing `:chat-cli` press `Ctrl-x` to switch into Dojo.
372+
373+**Important:** once a key has been used to boot a ship onto the network, it cannot be used to boot that ship again later - doing so will cause communication problems with other ships. For this reason you should **delete the keyfile from your machine once your ship has booted successfully**. (If you do use the same key twice, you'll need to conduct a [personal breach](#breaches) to restore your ship to full functionality).
372374
373375To shut down your ship, use `Ctrl-d`. To start your ship up again, run `./urbit sampel-palnet/` from the directory where your Urbit binary is saved. Note that in this usage, `sampel-palnet/` is the path of a folder, which by default is located in the same folder as the Urbit binary. This folder is called your ship's **pier**, and you can put it wherever you like.
374376