@@ -1,5 +1,6 @@
11---
22navhome: /docs/
3+navuptwo: true
34next: true
45sort: 1
56title: Install
@@ -23,31 +24,16 @@ with us at [urbit.org/stream](https://urbit.org/stream).
2324> lots of fun to play with, but not quite ready for your important or
2425> sensitive data.
2526
26−## Packages
27+### Update: `~2017.12.7`
2728
28−Urbit may be in your system's package repository — check there first. If not,
29−we host packages for some platforms. If you'd prefer to install from source, see
30−below.
29+Urbit `0.5.1` is now live! We expect there to be a delay in getting our
30+updated `urbit-0.5.1` binary packages propagated to Homebrew, APT and
31+the other various package managers. So for now, **please
32+build and install Urbit from source**. The instructions below will walk
33+you through how to do that. You'll then be free to continue the boot
34+and setup process as normal, per the rest of this Using docs section.
3135
32−**Mac OS X (Homebrew)**
33−
34−- `brew update`
35−- `brew install urbit`
36−
37−**FreeBSD**
38−
39−- Download `urbit-0.4.3.txz` [here](https://media.urbit.org/dist/freebsd/urbit-0.4.3.txz).
40−- Install with `pkg install urbit-0.4.3.txz`
41−
42−**Debian**
43−
44−- Download `urbit_0.4.5-1_amd64.deb` [here](https://media.urbit.org/dist/debian/urbit_0.4.5-1_amd64.deb).
45−- Install with `dpkg -i urbit_0.4.5-1_amd64.deb`
46−- Then `apt-get install -f` to install any missing dependencies
47−
48−## Source
49−
50−First, fetch the source tarball: **[urbit-0.4.5.tar.gz](https://media.urbit.org/dist/src/urbit-0.4.5.tar.gz)**.
36+## Build from source
5137
5238### Dependencies
5339
@@ -93,8 +79,8 @@ Which can usually be installed with the following one-liners:
9379
9480Once your dependencies are installed the rest is easy:
9581
96− $ tar xfvz urbit-0.4.5.tar.gz
97− $ cd urbit-0.4.5
82+ $ git clone https://github.com/urbit/urbit
83+ $ cd urbit
9884 $ make # gmake on FreeBSD
9985
10086After running `make`, your Urbit executable is in `bin/urbit`. Install it wherever you'd like.
@@ -109,16 +95,28 @@ Test that it works:
10995 urbit -w <myplanet> -t <myticket> if you have a ticket
11096 urbit <myplanet or mycomet> to restart an existing urbit
11197
112−## Setting up swap
98+### Boot your urbit
99+
100+And you're done! If you're running Urbit on a normal modern PC or Mac, or
101+on a large cloud instance, move onto the next [setup](../setup/) section to
102+boot your urbit.
103+
104+If you're running Urbit in the cloud on a small instance, however, read
105+the below section, as you may need to additionally configure swap space.
106+
107+### (Set up swap)
113108
114−Urbit wants to map 2GB of memory when it boots up. We won’t
115−necessarily use all this memory, we just want to see it. On a
116−normal modern PC or Mac, this is not an issue. On some small
117−cloud virtual machines (Amazon or Digital Ocean), the default
118−memory configuration is smaller than this, and you need to
119−manually configure a swapfile.
109+Urbit wants to map 2GB of memory when it boots up. We won’t necessarily
110+use all this memory, we just want to see it. On a normal modern PC or Mac,
111+or on a large cloud virtual machine, this is not an issue. On some small
112+cloud virtual machines (Amazon or Digital Ocean), the default memory
113+configuration is smaller than this, and you need to manually configure a
114+swapfile.
120115
121−Digital Ocean has a post on adding swap [here](https://www.digitalocean.com/community/tutorials/how-to-add-swap-on-ubuntu-14-04). For Amazon there’s a StackOverflow thread [here](http://stackoverflow.com/questions/17173972/how-do-you-add-swap-to-an-ec2-instance).
116+Digital Ocean has a post on adding swap
117+[here](https://www.digitalocean.com/community/tutorials/how-to-add-swap-on-ubuntu-14-04).
118+For Amazon there’s a StackOverflow thread
119+[here](http://stackoverflow.com/questions/17173972/how-do-you-add-swap-to-an-ec2-instance).
122120
123121Don’t spend a lot of time tweaking these settings; the simplest
124122thing is fine.