@@ -1,119 +0,0 @@
1−---
2−next: true
3−sort: 2
4−title: Install
5−---
6−
7−# Installation guide
8−
9−Urbit can be installed on most Unix systems. There is no Windows
10−port. Windows is a wonderful OS, we just haven't gotten to it yet.
11−Use a VM.
12−
13−## Configure the OS
14−
15−Urbit wants to map 2GB of memory when it boots up. We won't
16−necessarily use all this memory, we just want to see it. On a
17−normal modern PC or Mac, this is not an issue. On some small
18−cloud virtual machines (Amazon or Digital Ocean), the default
19−memory configuration is smaller than this, and you need to
20−manually configure a swapfile.
21−
22−To add swap to a DO droplet:
23−
24−https://www.digitalocean.com/community/tutorials/how-to-add-swap-on-ubuntu-14-04
25−
26−To add swap on an Amazon instance:
27−
28−http://stackoverflow.com/questions/17173972/how-do-you-add-swap-to-an-ec2-instance
29−
30−To add swap on a BSD instance:
31−
32− https://www.freebsd.org/doc/handbook/adding-swap-space.htm
33−
34−Don't spend a lot of time tweaking these settings; the simplest
35−thing is fine.
36−
37−## Install as a package
38−
39−### OS X - Homebrew
40−
41− brew install --HEAD homebrew/head-only/urbit
42−
43−### Ubuntu or Debian
44−
45−Third-party packages are available, at:
46−
47− https://github.com/yebyen/urbit-deb
48−
49−Urbit is only supported on Jessie onward (but outbound HTTPS
50−requests only work on Stretch; I wish we knew why; help us!)
51−
52−## Hand-build from source
53−
54−First, install all external dependencies. Then, make.
55−
56−### Dependencies
57−
58−urbit depends on:
59−
60− gcc (or clang)
61− gmp
62− libsigsegv
63− openssl
64− automake
65− autoconf
66− ragel
67− cmake
68− re2c
69− libtool
70− libssl-dev (Linux only)
71− ncurses (Linux only)
72−
73−#### Ubuntu or Debian
74−
75− sudo apt-get install libgmp3-dev libsigsegv-dev openssl libssl-dev libncurses5-dev git make exuberant-ctags automake autoconf libtool g++ ragel cmake re2c
76−
77−#### Fedora
78−
79− sudo dnf install gcc gcc-c++ git gmp-devel openssl-devel openssl ncurses-devel libsigsegv-devel ctags automake autoconf libtool ragel cmake re2c
80−
81−#### AWS
82−
83− sudo yum --enablerepo epel install gcc gcc-c++ git gmp-devel openssl-devel ncurses-devel libsigsegv-devel ctags automake autoconf libtool cmake re2c
84−
85−#### OS X - Homebrew
86−
87− brew install git gmp libsigsegv openssl libtool autoconf automake cmake
88−
89−#### OS X - Macports
90−
91− sudo port install git gmp libsigsegv openssl autoconf automake cmake
92−
93−Although `automake`/`autoconf`/`libtool` are generally installed by
94−default, some have reported needing to uninstall and reinstall those
95−three packages, at least with Homebrew. Your mileage may vary.
96−
97−#### FreeBSD
98−
99− pkg install git gmake gmp libsigsegv curl python automake autoconf ragel cmake re2c libtool
100−
101−#### Archlinux
102−
103− pacman -S gcc gmp libsigsegv openssl automake autoconf ragel cmake re2c libtool ncurses
104−
105−### Download and make
106−
107−Clone the repo:
108−
109− git clone git://github.com/urbit/urbit.git
110−
111−`cd` to the directory you just created:
112−
113− cd urbit
114−
115−Run `make`:
116−
117− make
118−
119−(On FreeBSD, use `gmake` instead.)