on master help sign in
Merge pull request #586 from urbit/ames-port-local-install
c7cbf8epoprox
content/getting-started/planet.md+15−7
@@ -48,18 +48,26 @@ If you received an email invite to Urbit, the master ticket should be a .pdf fil
48
48
49### Run the boot command {#the-dojo}
49### Run the boot command {#the-dojo}
50
50
51+For other ships on the network to communicate with your ship, the computer it's
52+running on needs to be able to receive inbound UDP traffic. Therefore, it's
53+important when running your ship locally to use the `-p ames_port` flag (replace
54+`ames_port` with a public port number from 49152 to 65535) to specify on which
55+port you'll receive UDP traffic, and to forward inbound UDP traffic arriving at
56+your router on that port to your computer.
57+
51−Navigate to your `urbit` directory.
58+Navigate to your `urbit` directory. Open your keyfile (it is just a text file)
52−
59+and copy the key inside. Paste it into the following command, except with
60+`ames_port` replaced with a public port number, and `sampel-palnet` replaced by
53−Open your keyfile (it is just a text file) and copy the key inside. Paste it into the following command, with `sampel-palnet` replaced by the name of your planet. **Do not include the tilde in your planet name.**
61+the name of your planet. **Do not include the tilde in your planet name.**
54
62
55```sh
63```sh
56−./urbit -w sampel-palnet -G rAnDoMkEy
64+./urbit -p ames_port -w sampel-palnet -G rAnDoMkEy
57```
65```
58
66
59Or you can copy the keyfile into the current directory and run:
67Or you can copy the keyfile into the current directory and run:
60
68
61```sh
69```sh
62−./urbit -w sampel-palnet -k ./my-planet.key
70+./urbit -p ames_port -w sampel-palnet -k ./my-planet.key
63```
71```
64
72
65Either command will create a directory called `sampel-palnet/` and begin booting your planet. It may take a few minutes.
73Either command will create a directory called `sampel-palnet/` and begin booting your planet. It may take a few minutes.
@@ -74,10 +82,10 @@ Get your password to log into landscape (the Urbit web interface) by typing:
74
82
75To shut down your planet, use `Ctrl-D`.
83To shut down your planet, use `Ctrl-D`.
76
84
77−To start your planet up again, run the following from your `urbit` directory.
85+To start your planet up again, run the following from your `urbit` directory, with `ames_port` replaced with the public port number you used when first booting your ship.
78
86
79```sh
87```sh
80−./urbit sampel-palnet
88+./urbit -p ames_port sampel-palnet
81```
89```
82
90
83Note that `sampel-palnet/` is the path of a folder, which we just created in your `urbit` directory. This folder is called your planet's **pier**, and it holds all of your data.
91Note that `sampel-palnet/` is the path of a folder, which we just created in your `urbit` directory. This folder is called your planet's **pier**, and it holds all of your data.