on master help sign in
Update getting-started/installing-urbit for 0.8.0.

Describes how to download static binaries for macOS and 64-bit Linux, and replaces the instructions for other operating systems with a catch-all using Nix and nixpkgs.

commit0c3bdb09c171f85d44fb24f6cc1c9e9615b3f5a0 authorJared Tobin <jared@jtobin.io> dateMon 17 Jun 2019, 19:59 (7 years ago) parent65793b2
1 file changed+13−157
getting-started/installing-urbit.md+13−157
getting-started/installing-urbit.md+13−157
@@ -19,174 +19,32 @@ Urbit: a personal server operating function
1919
2020## Instructions
2121
22−### MacOS
22+### macOS (Darwin)
2323
24−We recommend using the Homebrew package manager to run Arvo on MacOS.
24+We provide static binaries for macOS. You can grab the latest stable release as follows:
2525
2626```
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−
27+curl -O https://bootstrap.urbit.org/urbit-darwin-v0.8.0.tgz
28+tar xzf urbit-darwin-v0.8.0.tgz
29+./urbit
10630```
107−# Bash
10831
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
32+### Linux (64-bit)
11133
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
34+We also provide static binaries for 64-bit Linux distributions (Ubuntu, Debian, Fedora, Arch, etc.). You can get the latest stable release similarly:
12135
12236```
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
37+curl -O https://bootstrap.urbit.org/urbit-linux64-v0.8.0.tgz
38+tar xzf urbit-linux64-v0.8.0.tgz
39+./urbit
13540```
13641
137−### FreeBSD
42+### Other
13843
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
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:
15845
15946```
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−
47+nix-env -i urbit
19048urbit
19149```
19250
@@ -196,8 +54,6 @@ One you've completed your installation, you can continue on to the instructions
19654
19755Or, 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).
19856
199−
200−
20157## Set Up Swap
20258
20359If 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.