@@ -7,37 +7,44 @@ title: Install
77
88# Install
99
10−Urbit is designed to run on any Unix box with an internet connection. Debian
11−(jessie), OS X, FreeBSD and Fedora all work well.
10+Installing Urbit is easy. It just takes a few minutes to get an
11+instance up and running on the network.
1212
13−Urbit is alpha software. It’s not yet completely stable, its crypto hasn’t
14−been audited, and there are plenty of rough edges. Urbit is lots of fun to play
15−with, but not quite ready for your important or sensitive data.
13+Urbit is designed to run on any Unix box with an internet connection.
14+Debian (jessie), Mac OS X, FreeBSD and Fedora all work well.
1615
17−### Setting up swap
16+If you run into trouble installing Urbit, please let us know via
17+email, [questions@urbit.org](mailto:questions@urbit.org), or on the
18+forum: [urbit.org/fora](https://urbit.org/fora). You can also chat
19+with us at [urbit.org/stream](https://urbit.org/fora).
1820
19−Urbit wants to map 2GB of memory when it boots up. We won’t
20−necessarily use all this memory, we just want to see it. On a
21−normal modern PC or Mac, this is not an issue. On some small
22−cloud virtual machines (Amazon or Digital Ocean), the default
23−memory configuration is smaller than this, and you need to
24−manually configure a swapfile.
21+> Urbit is alpha software. It’s not yet completely stable, its crypto
22+> hasn’t been audited, and there are plenty of rough edges. Urbit is
23+> lots of fun to play with, but not quite ready for your important or
24+> sensitive data.
2525
26−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).
26+## Packages
2727
28−Don’t spend a lot of time tweaking these settings; the simplest
29−thing is fine.
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.
3031
31−## Install a package
32+#### Mac OS X (Homebrew)
33+- `brew update`
34+- `brew install urbit`
3235
33−Urbit may be in your system's package repository - check there first. If not, we host packages for some platforms:
36+#### FreeBSD
37+- Download `urbit-0.4.txz` [here](https://media.urbit.org/dist/freebsd/urbit-0.4.txz).
38+- Install with `pkg install urbit-0.4.txz`
3439
35−[FreeBSD](https://media.urbit.org/dist/freebsd/urbit-0.4.txz): install with `pkg install urbit-0.4.txz`.
36−[Debian](https://media.urbit.org/dist/debian/urbit_0.4-1_amd64.deb): install with `dpkg -i urbit_0.4-1_amd64.deb`, followed by `apt-get install -f` to install any missing dependencies.
40+#### Debian
41+- Download `urbit_0.4-1_amd64.deb` [here](https://media.urbit.org/dist/debian/urbit_0.4-1_amd64.deb).
42+- Install with `dpkg -i urbit_0.4-1_amd64.deb`
43+- Then `apt-get install -f` to install any missing dependencies
3744
38−## Build from source
45+## Source
3946
40−First, fetch the source tarball from [here](https://media.urbit.org/dist/src/urbit-0.4.tar.gz).
47+First, fetch the source tarball from [media.urbit.org/dist/src/urbit-0.4.tar.gz](https://media.urbit.org/dist/src/urbit-0.4.tar.gz).
4148
4249### Dependencies
4350
@@ -90,3 +97,17 @@ Once your dependencies are installed the rest is easy:
9097After running `make`, your Urbit executable is in `bin/urbit`. Install it wherever you'd like.
9198
9299 # sudo install -m 0755 bin/urbit /usr/local/bin
100+
101+## Setting up swap
102+
103+Urbit wants to map 2GB of memory when it boots up. We won’t
104+necessarily use all this memory, we just want to see it. On a
105+normal modern PC or Mac, this is not an issue. On some small
106+cloud virtual machines (Amazon or Digital Ocean), the default
107+memory configuration is smaller than this, and you need to
108+manually configure a swapfile.
109+
110+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).
111+
112+Don’t spend a lot of time tweaking these settings; the simplest
113+thing is fine.