git.iko.soy/urbit.org
on master help sign in
CR Consistent Style
413fae9Zach Alberico
content/using/install.md+16−13
compare with master
unifiedsplit
@@ -42,19 +42,17 @@ Once you've followed the appropriate install instructions, you can check if ever
42Urbit: a personal server operating function
42Urbit: a personal server operating function
43```
43```
44
44
45−### macOS
45+### macOS and Linux
46
46
47```sh
47```sh
48+macOS:
48mkdir urbit
49mkdir urbit
49cd urbit
50cd urbit
50curl -O https://bootstrap.urbit.org/urbit-v0.10.8-darwin.tgz
51curl -O https://bootstrap.urbit.org/urbit-v0.10.8-darwin.tgz
51tar xzf urbit-v0.10.8-darwin.tgz
52tar xzf urbit-v0.10.8-darwin.tgz
52./urbit-v0.10.8-darwin/urbit
53./urbit-v0.10.8-darwin/urbit
53−```
54−
55−### Linux (64-bit)
56
54
57−```sh
55+Linux:
58mkdir urbit
56mkdir urbit
59cd urbit
57cd urbit
60curl -O https://bootstrap.urbit.org/urbit-v0.10.8-linux64.tgz
58curl -O https://bootstrap.urbit.org/urbit-v0.10.8-linux64.tgz
@@ -63,7 +61,6 @@ tar xzf urbit-v0.10.8-linux64.tgz
63```
61```
64
62
65To access your Urbit via HTTP on port 80 on Ubuntu, you may need to run the following:
63To access your Urbit via HTTP on port 80 on Ubuntu, you may need to run the following:
66−
67```sh
64```sh
68sudo apt-get install libcap2-bin
65sudo apt-get install libcap2-bin
69sudo setcap 'cap_net_bind_service=+ep' /path/to/urbit
66sudo setcap 'cap_net_bind_service=+ep' /path/to/urbit
@@ -72,11 +69,17 @@ sudo setcap 'cap_net_bind_service=+ep' /path/to/urbit
72
69
73### Windows
70### Windows
74
71
75−> Please note that this method of installing Urbit is experimental, and we may not be able to assist you if you encounter issues related to WSL 2. These instructions have been tested and verified for WSL 2 + Ubuntu 18.04 LTS.
72+> Please note that this method of installing Urbit is experimental, and we may not be able to assist you if you encounter issues related to WSL 2.
76
73
77−Urbit cannot run on Windows itself, but there is a convenient way to run a Linux distro using the [Windows Subsystem for Linux 2](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux) on Windows 10. For Urbit to work, it is necessary to [install WSL 2](https://docs.microsoft.com/en-us/windows/wsl/wsl2-install) and not just WSL.
74+These instructions have been tested and verified for WSL 2 + Ubuntu 18.04 LTS.
78
75
76+Urbit cannot run on Windows itself, but there is a convenient way to run a Linux distro using the [Windows Subsystem for Linux 2](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux) on Windows 10.
77+
78+For Urbit to work, it is necessary to [install WSL 2](https://docs.microsoft.com/en-us/windows/wsl/wsl2-install) and not just WSL.
79+
80+Once WSL 2 is installed, open a Linux terminal in Windows and then follow the Linux installation instructions above.
81+
79−Once WSL 2 is installed, open a Linux terminal in Windows and then follow the Linux installation instructions above. For performance reasons, do not install Urbit in the mounted Windows volume, but install it in the Linux file system. For example, in your home directory, by typing `cd ~`.
82+For performance reasons, do not install Urbit in the mounted Windows volume, but install it in the Linux file system. For example, in your home directory, by typing `cd ~`.
80
83
81## Launching Urbit
84## Launching Urbit
82
85
@@ -102,10 +105,10 @@ To boot a comet, go into the command line and run the following command from the
102
105
103```sh
106```sh
104macOS:
107macOS:
105−$ ./urbit-v0.10.8-darwin/urbit -c mycomet
108+./urbit-v0.10.8-darwin/urbit -c mycomet
106
109
107Linux:
110Linux:
108−$ ./urbit-v0.10.8-linux64/urbit -c mycomet
111+./urbit-v0.10.8-linux64/urbit -c mycomet
109```
112```
110
113
111This will take up to an hour, and will spin out a bunch of boot messages. It will also create a directory called `mycomet` in the Unix directory that you ran the command from (which should be your `urbit` directory).
114This will take up to an hour, and will spin out a bunch of boot messages. It will also create a directory called `mycomet` in the Unix directory that you ran the command from (which should be your `urbit` directory).
@@ -127,10 +130,10 @@ To exit Urbit, use `Ctrl-D` or enter `|exit` into Dojo.
127To start your ship up again, run the following from your `urbit` directory (note the lack of `-c` argument):
130To start your ship up again, run the following from your `urbit` directory (note the lack of `-c` argument):
128```sh
131```sh
129macOS:
132macOS:
130−$ ./urbit-v0.10.8-darwin/urbit mycomet
133+./urbit-v0.10.8-darwin/urbit mycomet
131
134
132Linux:
135Linux:
133−$ ./urbit-v0.10.8-linux64/urbit mycomet
136+./urbit-v0.10.8-linux64/urbit mycomet
134```
137```
135
138
136### The Dojo
139### The Dojo