git.iko.soy/urbit.org
on b93c19b help sign in
urbit.org/getting-started/installing-urbit.md
71 lines 3.2 kB history raw
1+++
2title = "Installing Urbit"
3weight = 2
4template = "doc.html"
5+++
7Arvo runs nicely on a Unix-like operating system – Ubuntu, Fedora, macOS, and FreeBSD, for example. If you're using Windows, you'll need to get one of the aforementioned systems. Don't worry: most of them are free. Let's get it onto your machine.
9But first, some terminology:
11- `vere` or `urbit`: the interpreter that runs when you run a command like `urbit` or `/bin/urbit` in your command line
12- `arvo`: the deterministic OS that lives in a directory whose name matches your Azimuth point, ie `~famreb-todmec` lives in `/famreb-todmec`
14We have different installation instructions for different platforms. To install and run Arvo, run the commands that are listed for your operating system.
16On any platform, you can check your Arvo installation by running the `urbit` command. Installation was successful if you get a block of output that begins with the line below:
18```
19Urbit: a personal server operating function
20```
22## Instructions
24### macOS (Darwin)
26We provide static binaries for macOS. You can grab the latest stable release as follows:
28```
29curl -O https://bootstrap.urbit.org/urbit-darwin-v0.8.0.tgz
30tar xzf urbit-darwin-v0.8.0.tgz
31./urbit
32```
34### Linux (64-bit)
36We also provide static binaries for 64-bit Linux distributions (Ubuntu, Debian, Fedora, Arch, etc.). You can get the latest stable release similarly:
38```
39curl -O https://bootstrap.urbit.org/urbit-linux64-v0.8.0.tgz
40tar xzf urbit-linux64-v0.8.0.tgz
41./urbit
42```
44To access your Urbit via HTTP on port 80, you may need to run the following:
45`sudo apt-get install libcap2-bin`
46`sudo setcap 'cap_net_bind_service=+ep' $(which urbit)`
48### Other
50We maintain a [Nix](https://nixos.org/nix) derivation for Urbit in [nixpkgs](https://github.com/NixOS/nixpkgs), however we're still in the process of updating it to `v0.8.0`. Once available, you will be able to install and launch it like so:
52```
53nix-env -i urbit
54urbit
55```
57## Booting a Ship
59One you've completed your installation, you can continue on to the instructions for [booting your ship](@/docs/getting-started/booting-a-ship.md) to get on the Arvo network.
61Or, if you want to try testing and writing code, check out the guide to [getting an unnetworked development ship](/docs/using/creating-a-development-ship).
63## Set Up Swap
65If you're running Urbit in the cloud on a small instance, you may need to additionally configure swap space. If you're not, you can safely ignore this section.
67Urbit wants to map 2GB of memory when it boots up. We won’t necessarily use all this memory, we just want to see it. On a normal modern PC or Mac, or on a large cloud virtual machine, this is not an issue. On some small cloud virtual machines (Amazon or Digital Ocean), the default memory configuration is smaller than this, and you need to manually configure a swapfile.
69Digital Ocean has a post on adding swap [here](https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-16-04). For Amazon there’s a StackOverflow thread [here](https://stackoverflow.com/questions/17173972/how-do-you-add-swap-to-an-ec2-instance).
71Don’t spend a lot of time tweaking these settings; the simplest thing is fine.