@@ -19,32 +19,174 @@ Urbit: a personal server operating function
1919
2020## Instructions
2121
22−### macOS (Darwin)
22+### MacOS
2323
24−We provide static binaries for macOS. You can grab the latest stable release as follows:
24+We recommend using the Homebrew package manager to run Arvo on MacOS.
2525
2626```
27−curl -O https://bootstrap.urbit.org/urbit-darwin-v0.8.0.tgz
28−tar xzf urbit-darwin-v0.8.0.tgz
29−./urbit
27+# Bash
28+
29+brew update
30+brew install -v gcc git gmp libsigsegv libtool meson ninja pkg-config openssl
31+git clone https://github.com/urbit/urbit
32+cd urbit
33+./scripts/bootstrap
34+./scripts/build
35+sudo ninja -C ./build/ meson-install
36+urbit
37+```
38+
39+### Ubuntu or Debian
40+
41+```
42+# Bash
43+
44+sudo apt-get update
45+sudo apt-get install g++ git libcurl4-gnutls-dev libgmp3-dev libncurses5-dev libsigsegv-dev libssl-dev make openssl pkg-config python python3 python3-pip python3-setuptools zlib1g-dev ninja-build
46+sudo -H pip3 install --upgrade pip
47+sudo -H pip3 install meson
48+
49+git clone https://github.com/urbit/urbit
50+cd urbit
51+./scripts/bootstrap
52+./scripts/build
53+sudo ninja -C ./build/ install
54+urbit
55+```
56+
57+To access your Urbit via HTTP on port 80, you may need to run the following:
58+
59+```
60+sudo apt-get install libcap2-bin
61+sudo setcap 'cap_net_bind_service=+ep' $(which urbit)
62+```
63+
64+### Fedora 23 or earlier
65+
66+```
67+# Bash
68+
69+sudo yum upgrade
70+sudo yum install autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel libtool ncurses-devel ninja-build openssl openssl-devel pkgconfig python3 re2c wget
71+
72+# meson requires python 3.5; RHEL supplies wrong version
73+pushd /usr/src
74+ sudo wget https://www.python.org/ftp/python/3.5.5/Python-3.5.5.tgz
75+ sudo tar xzf Python-3.5.5.tgz
76+ cd Python-3.5.5
77+ sudo ./configure --enable--optimizations
78+ sudo make altinstall
79+ which python3.5
80+ cd /usr/local/bin
81+ sudo ln -s python3.5 python3
82+ hash python3
83+popd
84+
85+curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
86+sudo /usr/local/bin/python3 get-pip.py
87+# downgrade meson to avoid dependencies that redhat can't meet
88+sudo -H /usr/local/bin/pip3 install meson
89+
90+
91+git clone git://github.com/ninja-build/ninja.git && cd ninja
92+git checkout release
93+./configure.py --bootstrap
94+sudo cp ./ninja /usr/local/bin
95+
96+git clone https://github.com/urbit/urbit
97+cd urbit
98+./scripts/bootstrap
99+./scripts/build
100+sudo /usr/local/bin/ninja -C ./build/ install
101+urbit
102+```
103+
104+### Fedora 24 or later
105+
30106```
107+# Bash
31108
32−### Linux (64-bit)
109+sudo dnf upgrade
110+sudo dnf install autoconf automake cmake ctags gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel libtool ncurses-devel meson ninja-build openssl openssl-devel pkgconfig python3 re2c wget
33111
34−We also provide static binaries for 64-bit Linux distributions (Ubuntu, Debian, Fedora, Arch, etc.). You can get the latest stable release similarly:
112+git clone https://github.com/urbit/urbit
113+cd urbit
114+./scripts/bootstrap
115+./scripts/build
116+sudo ninja -C ./build/ install
117+urbit
118+```
119+
120+### Arch Linux
35121
36122```
37−curl -O https://bootstrap.urbit.org/urbit-linux64-v0.8.0.tgz
38−tar xzf urbit-linux64-v0.8.0.tgz
39−./urbit
123+# Bash
124+
125+sudo pacman -Syyu
126+sudo pacman -S --needed curl gcc git gmp libsigsegv ncurses ninja openssl python python-pip meson
127+git clone https://github.com/urbit/urbit
128+cd urbit
129+./scripts/bootstrap
130+./scripts/build
131+cd build
132+ninja
133+sudo ninja meson-install
134+urbit
40135```
41136
42−### Other
137+### FreeBSD
43138
44−We maintain a [Nix](https://nixos.org/nix) derivation for Urbit in [nixpkgs](https://github.com/NixOS/nixpkgs). You can install and launch it like so:
139+```
140+# Bash or Sh
141+
142+pkg upgrade
143+sudo pkg install curl gcc git gmake gmp libsigsegv python python3 ncurses openssl gmp
144+curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
145+sudo python3 get-pip.py
146+sudo -H pip install --upgrade pip
147+sudo -H pip install meson
148+sudo pkg install ninja
149+git clone https://github.com/urbit/urbit
150+cd urbit
151+sh ./scripts/bootstrap
152+sh ./scripts/build
153+sudo ninja -C ./build/ meson-install
154+urbit
155+```
156+
157+### Amazon Web Services
45158
46159```
47−nix-env -i urbit
160+# Bash
161+
162+sudo yum update
163+sudo yum install gcc gcc-c++ git gmp-devel libcurl-devel libsigsegv-devel ncurses-devel openssl openssl-devel pkgconfig python3 python3-pip wget git
164+sudo env "PATH=$PATH" pip3 install --upgrade pip
165+sudo env "PATH=$PATH" pip3 install meson
166+
167+
168+# we need libsigsegv
169+#
170+
171+wget https://dl.fedoraproject.org/pub/fedora/linux/releases/30/Everything/x86_64/os/Packages/l/libsigsegv-2.11-7.fc30.x86_64.rpm
172+wget https://dl.fedoraproject.org/pub/fedora/linux/releases/30/Everything/x86_64/os/Packages/l/libsigsegv-devel-2.11-7.fc30.x86_64.rpm
173+sudo yum localinstall libsigsegv-2.11-7.fc30.x86_64.rpm
174+sudo yum localinstall libsigsegv-devel-2.11-7.fc30.x86_64.rpm
175+
176+git clone git://github.com/ninja-build/ninja.git
177+pushd ninja
178+ git checkout release
179+ ./configure.py --bootstrap
180+ sudo cp ./ninja /usr/local/bin
181+popd
182+
183+
184+git clone https://github.com/urbit/urbit
185+cd urbit
186+./scripts/bootstrap
187+./scripts/build
188+sudo env "PATH=$PATH" ninja -C ./build/ install
189+
48190urbit
49191```
50192
@@ -54,6 +196,8 @@ One you've completed your installation, you can continue on to the instructions
54196
55197Or, 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).
56198
199+
200+
57201## Set Up Swap
58202
59203If 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.