@@ -138,7 +138,7 @@ But first, some terminology:
138138- `arvo`: the deterministic OS that lives in a directory whose name matches your Azimuth point, ie `~famreb-todmec` lives in `/famreb-todmec`
139139
140140Arvo runs nicely on a Unix-like operating system -- Ubuntu,
141−Fedora, macOS, and FreeBSD. If you're using Windows, you'll need
141+Fedora, macOS, and FreeBSD, for example. If you're using Windows, you'll need
142142to get one of the aforementioned systems. Don't worry: most of them are free.
143143
144144We have different installation instructions for different platforms. To install
@@ -152,6 +152,29 @@ with the line below:
152152Urbit: a personal server operating function
153153```
154154
155+### Dependencies
156+
157+Urbit depends on:
158+
159+
160+```
161+C compiler (gcc or clang)
162+curses
163+git
164+gmp
165+libcurl
166+libsigsegv
167+libuv
168+meson
169+ninja
170+openssl
171+pkg-config
172+python2
173+zlib
174+```
175+
176+### Instructions
177+
155178#### MacOS
156179
157180We recommend using the Homebrew package manager to run Arvo on MacOS.
@@ -160,7 +183,7 @@ We recommend using the Homebrew package manager to run Arvo on MacOS.
160183# Bash
161184
162185brew update
163−brew install autoconf automake cmake gcc git gmp libsigsegv libtool meson ninja pkg-config python2 openssl re2c
186+brew install gcc git gmp libsigsegv libtool meson ninja pkg-config python2 openssl
164187git clone https://github.com/urbit/urbit
165188cd urbit
166189./scripts/bootstrap
@@ -175,7 +198,7 @@ urbit
175198# Bash
176199
177200sudo apt-get update
178−sudo apt-get install autoconf automake cmake exuberant-ctags g++ git libcurl4-gnutls-dev libgmp3-dev libncurses5-dev libsigsegv-dev libssl-dev libtool make openssl pkg-config python python3 python3-pip ragel re2c zlib1g-dev
201+sudo apt-get install g++ git libcurl4-gnutls-dev libgmp3-dev libncurses5-dev libsigsegv-dev libssl-dev make openssl pkg-config python python3 python3-pip zlib1g-dev
179202sudo -H pip3 install --upgrade pip
180203sudo -H pip3 install meson==0.29
181204
@@ -185,12 +208,11 @@ sudo -H pip3 install meson==0.29
185208#
186209git clone git://github.com/ninja-build/ninja.git
187210pushd ninja
188− git checkout release
189− ./configure.py --bootstrap
190− sudo cp ./ninja /usr/local/bin
211+ git checkout release
212+ ./configure.py --bootstrap
213+ sudo cp ./ninja /usr/local/bin
191214popd
192215
193−
194216git clone https://github.com/urbit/urbit
195217cd urbit
196218./scripts/bootstrap
@@ -209,15 +231,15 @@ sudo yum install autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl
209231
210232# meson requires python 3.5; RHEL supplies wrong version
211233pushd /usr/src
212− sudo wget https://www.python.org/ftp/python/3.5.5/Python-3.5.5.tgz
213− sudo tar xzf Python-3.5.5.tgz
214− cd Python-3.5.5
215− sudo ./configure --enable--optimizations
216− sudo make altinstall
217− which python3.5
218− cd /usr/local/bin
219− sudo ln -s python3.5 python3
220− hash python3
234+ sudo wget https://www.python.org/ftp/python/3.5.5/Python-3.5.5.tgz
235+ sudo tar xzf Python-3.5.5.tgz
236+ cd Python-3.5.5
237+ sudo ./configure --enable--optimizations
238+ sudo make altinstall
239+ which python3.5
240+ cd /usr/local/bin
241+ sudo ln -s python3.5 python3
242+ hash python3
221243popd
222244
223245curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
@@ -245,7 +267,7 @@ urbit
245267# Bash
246268
247269sudo pacman -Syu
248−sudo pacman -S autoconf automake cmake curl gcc git gmp libsigsegv libtool ncurses ninja openssl python ragel re2c
270+sudo pacman -S curl gcc git gmp libsigsegv ncurses ninja openssl python
249271curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
250272sudo python3 get-pip.py
251273git clone https://github.com/urbit/urbit
@@ -256,15 +278,73 @@ sudo ninja -C ./build/ meson-install
256278urbit
257279```
258280
259−If you just want to use a fake ship for development purposes, you can now use
281+##### FreeBSD
282+
283+```
284+# Bash or Sh
285+
286+pkg upgrade
287+sudo pkg install curl gcc git gmake gmp libsigsegv python python3 ncurses openssl gmp
288+curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
289+sudo python3 get-pip.py
290+sudo -H pip install --upgrade pip
291+sudo -H pip install meson
292+sudo pkg install ninja
293+git clone https://github.com/urbit/urbit
294+cd urbit
295+sh ./scripts/bootstrap
296+sh ./scripts/build
297+sudo ninja -C ./build/ meson-install
298+urbit
299+```
300+
301+##### Amazon Web Services
302+
303+```
304+# Bash
305+
306+sudo yum update
307+sudo yum install gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel ncurses-devel openssl openssl-devel pkgconfig python2 python3 python3-pip wget git
308+sudo env "PATH=$PATH" pip3 install --upgrade pip
309+sudo env "PATH=$PATH" pip3 install meson
310+
311+
312+# we need libsigsegv
313+#
314+
315+wget http://dl.fedoraproject.org/pub/fedora/linux/releases/25/Everything/x86_64/os/Packages/l/libsigsegv-2.10-10.fc24.x86_64.rpm
316+wget http://dl.fedoraproject.org/pub/fedora/linux/releases/25/Everything/x86_64/os/Packages/l/libsigsegv-devel-2.10-10.fc24.x86_64.rpm
317+sudo yum localinstall libsigsegv-2.10-10.fc24.x86_64.rpm
318+sudo yum localinstall libsigsegv-devel-2.10-10.fc24.x86_64.rpm
319+
320+git clone git://github.com/ninja-build/ninja.git
321+pushd ninja
322+ git checkout release
323+ ./configure.py --bootstrap
324+ sudo cp ./ninja /usr/local/bin
325+popd
326+
327+
328+git clone https://github.com/urbit/urbit
329+cd urbit
330+./scripts/bootstrap
331+./scripts/build
332+sudo env "PATH=$PATH" ninja -C ./build/ install
333+
334+urbit
335+```
336+
337+### Using a Fake Ship
338+
339+Perhaps you want to boot a ship without an identity. We recommend doing that
340+for development purposes, or if you just want to play around with an
341+un-networked ship without getting a point. You can now use
260342the command of the scheme below to boot a fake `~zod`.
261343
262344```
263345urbit -F zod
264346```
265347
266−You can substitute any valid galaxy-, star-, or planet-name for `zod`.
267−
268348If you want to get on the Arvo network with your point, then continue to the
269349next section.
270350
@@ -304,15 +384,14 @@ keyfile:
304384urbit -w ~sample-planet -k path/to/my-planet.key
305385```
306386
307−if you'd prefer to copy your key in you can run
387+Or, if you'd prefer to copy your key in, you can run:
308388
309389```
310390urbit -w ~sample-planet -G rAnDoMkEy
311391```
312392
313−
314−This will create a directory called `sample-planet/` and begin building your
315−ship. It may take a few minutes.
393+Either command will create a directory called `sample-planet/` and begin
394+building your ship. It may take a few minutes.
316395
317396When your ship is finished booting, you will see the `~sample-planet:dojo>`
318397prompt. At that point, you should permanently erase your keyfile from your