@@ -12,11 +12,11 @@ Installing Urbit is easy. It just takes a few minutes to get an
12instance up and running on the network.
12instance up and running on the network.
14Urbit is designed to run on any Unix box with an internet connection.
14Urbit is designed to run on any Unix box with an internet connection.
15−Debian (jessie), Mac OS X, FreeBSD and Fedora all work well.
15+macOS, Ubuntu/Debian, FreeBSD, and Fedora all work well.
17If you run into trouble installing Urbit, please let us know via
17If you run into trouble installing Urbit, please let us know via
18email, [questions@urbit.org](mailto:questions@urbit.org), or on the
18email, [questions@urbit.org](mailto:questions@urbit.org), or on the
19−forum: [urbit.org/fora](https://urbit.org/fora). You can also chat
19+forum: [fora.urbit.org](https://fora.urbit.org). You can also chat
20with us at [urbit.org/stream](https://urbit.org/stream).
20with us at [urbit.org/stream](https://urbit.org/stream).
22> Urbit is alpha software. It’s not yet completely stable, its crypto
22> Urbit is alpha software. It’s not yet completely stable, its crypto
@@ -41,57 +41,157 @@ gmp
50−Which can usually be installed with the following one-liners:
53+### Instructions
55+First, you'll install the required dependencies to build Urbit from source. Then, you'll clone the Urbit source code, hosted on Github. Next, you'll bootstrap the Git submodules needed for the build. Lastly, you'll run a [Meson](https://github.com/mesonbuild/meson) build on the Urbit source to create your Urbit binary for your host operating system. Then, finally, you'll be able to boot your urbit.
57+For your host OS platform and relevant package installer, run the respective Bash shell commands listed below in a fresh terminal window to get Urbit installed:
59+> For those new to the command line, see:
61+> - Mac: [Introduction to the Mac OS X Command Line](http://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line)
62+> - Linux: [An Introduction to the Linux Terminal](https://www.digitalocean.com/community/tutorials/an-introduction-to-the-linux-terminal)
68+> [Homebrew installation guide](https://treehouse.github.io/installation-guides/mac/homebrew)
53−# macOS (Homebrew) https://treehouse.github.io/installation-guides/mac/homebrew
71+# Bash
54−# Linuxbrew http://linuxbrew.sh/
72+
55−$ brew install autoconf automake cmake gcc git gmp libsigsegv libtool meson ninja pkg-config python2 openssl re2c
74+brew install autoconf automake cmake gcc git gmp libsigsegv libtool meson ninja pkg-config python2 openssl re2c
75+git clone https://github.com/urbit/urbit
79+sudo install -m 0755 ./build/urbit /usr/local/bin
57−# macOS (Macports)
83+##### Macports
58−$ sudo port install autoconf automake cmake gmp libsigsegv openssl
60−# Ubuntu or Debian
85+```
61−$ 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 python ragel re2c zlib1g-dev
89+sudo port install autoconf automake cmake gmp libsigsegv meson openssl
90+git clone https://github.com/urbit/urbit
94+sudo install -m 0755 ./build/urbit /usr/local/bin
64−$ sudo dnf install autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel libtool ncurses-devel openssl openssl-devel python2 ragel re2c
66−# FreeBSD
100+##### Linuxbrew
67−$ pkg install autoconf automake cmake curl gcc git gmake gmp libsigsegv libtool python ragel re2c
69−# Arch
102+> [Linuxbrew](http://linuxbrew.sh/)
70−$ pacman -S autoconf automake cmake curl gcc git gmp libsigsegv libtool ncurses openssl python ragel re2c
73−$ sudo yum install --enablerepo epel autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel libtool ncurses-devel openssl-devel python re2c
108+brew install autoconf automake cmake gcc git gmp libsigsegv libtool meson ninja pkg-config python2 openssl re2c
109+git clone https://github.com/urbit/urbit
113+sudo install -m 0755 ./build/urbit /usr/local/bin
76−### Clone and make
117+##### Ubuntu or Debian
78−Once your dependencies are installed the rest is easy:
119+```
123+sudo apt-get install autoconf automake cmake exuberant-ctags g++ git libcurl4-gnutls-dev libgmp3-dev libncurses5-dev libsigsegv-dev libssl-dev libtool make meson openssl python ragel re2c zlib1g-dev
124+git clone https://github.com/urbit/urbit
128+sudo install -m 0755 ./build/urbit /usr/local/bin
138+sudo dnf install autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel libtool meson ncurses-devel openssl openssl-devel python2 ragel re2c
139+git clone https://github.com/urbit/urbit
143+sudo install -m 0755 ./build/urbit /usr/local/bin
153+pkg install autoconf automake cmake curl gcc git gmake gmp libsigsegv libtool meson python ragel re2c
81−$ git clone https://github.com/urbit/urbit
154+git clone https://github.com/urbit/urbit
82−$ cd urbit
155+cd urbit
83−$ ./scripts/bootstrap
156+./scripts/bootstrap
84−$ ./scripts/build
157+./scripts/build
158+sudo install -m 0755 ./build/urbit /usr/local/bin
87−After running the build script, your Urbit executable is in `build/urbit`.
162+##### Arch
88−Install it wherever you'd like.
168+pacman -S autoconf automake cmake curl gcc git gmp libsigsegv libtool meson ncurses openssl python ragel re2c
169+git clone https://github.com/urbit/urbit
91−$ sudo install -m 0755 build/urbit /usr/local/bin
173+sudo install -m 0755 ./build/urbit /usr/local/bin
94−Test that it works:
177+##### AWS
183+sudo yum install --enablerepo epel autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel libtool meson ncurses-devel openssl-devel python re2c
184+git clone https://github.com/urbit/urbit
188+sudo install -m 0755 ./build/urbit /usr/local/bin
192+### Test for successful installation
194+After running your installed `urbit` command, check to see if the following output was printed:
@@ -145,14 +245,15 @@ Simple Usage:
145 urbit <myplanet or mycomet> to restart an existing urbit
245 urbit <myplanet or mycomet> to restart an existing urbit
248+If so, then you're ready to boot your urbit. If not, check that you entered each Bash command correctly for your host OS platform. If you're still experiencing issues, feel free to drop into [Urbit chat](https://urbit.org/stream) for troubleshooting help.
148### Boot your urbit
250### Boot your urbit
150−And you're done! If you're running Urbit on a normal modern PC or Mac, or
252+You've now installed the Urbit binary. If you're running Urbit on a normal modern PC or Mac, or
151−on a large cloud instance, move onto the next [setup](../setup/) section to
253+on a large cloud instance, move onto the next [setup](../setup/) section.
154−If you're running Urbit in the cloud on a small instance, however, read
255+If you're running Urbit in the cloud on a small instance, read
155−the below section, as you may need to additionally configure swap space.
256+the below section, as you may need to additionally configure swap space, then continue.
157### (Set up swap)
258### (Set up swap)
@@ -164,7 +265,7 @@ configuration is smaller than this, and you need to manually configure a
166Digital Ocean has a post on adding swap
267Digital Ocean has a post on adding swap
167−[here](https://www.digitalocean.com/community/tutorials/how-to-add-swap-on-ubuntu-14-04).
268+[here](https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-16-04).
168For Amazon there’s a StackOverflow thread
269For Amazon there’s a StackOverflow thread
169[here](http://stackoverflow.com/questions/17173972/how-do-you-add-swap-to-an-ec2-instance).
270[here](http://stackoverflow.com/questions/17173972/how-do-you-add-swap-to-an-ec2-instance).