git.iko.soy/urbit.org
on 9548521 help sign in
urbit.org/content/install.md
69 lines 3.3 kB history raw
1+++
2title = "Install"
3template = "page_indiced.html"
4+++
6## Getting an Urbit ID {#id}
8For an introduction to Urbit IDs and the address space more generally, see [Urbit ID](@/understanding-urbit/urbit-id.md) in [Understanding Urbit](@/understanding-urbit/_index.md).
10While Tlon does not currently sell or distribute Urbit IDs, there are still a few ways to get your own Urbit ID:
12- Getting an invitation from a friend
13- Purchasing an Urbit ID from a third party, such as [urbit.live](https://urbit.live) or [OpenSea](https://opensea.io).
15Tlon occasionally selects candidates to distribute invitations, and users operating galaxies and stars can spawn and distribute a finite number of stars and planets, respectively.
17## Install Urbit {#urbit}
19The Urbit binary runs nicely on a Unix-like operating system – Ubuntu, Fedora, or macOS, for example. If you're using Windows, you'll need to get one of the aforementioned systems. But first, some terminology:
21- `vere` or `urbit`: the interpreter that runs when you run a command like `./urbit` in your command line
22- `arvo`: the deterministic OS that lives in a directory whose name matches your Urbit ID, i.e. `~famreb-todmec` lives in `/famreb-todmec`
24We have different installation instructions for different platforms. To install and run Arvo, the Urbit operating system, and its binary, run the commands that are listed for your operating system.
26You can check your Arvo installation on any platform by running the `./urbit` command. Installation was successful if you get a block of output that begins with the line below:
28```
29Urbit: a personal server operating function
30```
32### macOS
34We provide static binaries for macOS. You can grab the latest stable release as follows:
36```sh
37curl -O https://bootstrap.urbit.org/urbit-darwin-v0.8.2.tgz
38tar xzf urbit-darwin-v0.8.2.tgz
39./urbit
40```
42### Linux (64-bit)
44We also provide static binaries for 64-bit Linux distributions (Ubuntu, Debian, Fedora, Arch, etc.). You can get the latest stable release similarly:
46```sh
47curl -O https://bootstrap.urbit.org/urbit-linux64-v0.8.2.tgz
48tar xzf urbit-linux64-v0.8.2.tgz
49./urbit
50```
52To access your Urbit via HTTP on port 80 on Ubuntu, you may need to run the following:
54```sh
55sudo apt-get install libcap2-bin
56sudo setcap 'cap_net_bind_service=+ep' /path/to/urbit
57```
59### Compile from source
61If you want to compile from source, see the [instructions on GitHub](https://github.com/urbit/urbit#development).
63### About swap space
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. It won’t necessarily use all this memory, it just wants 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).