content/getting-started/cli.md · urbit.org

git.iko.soy/urbit.org

on 30aa030 help sign in

urbit.org/content/getting-started/cli.md

201 lines 7.4 kB history raw

1+++

2title = "Command line install"

3weight = 4

4description = "Installation instructions for power users."

5tag = "additional"

6+++

8If you're a power user, you can run the Urbit virtual machine directly using the command line. Choose the code for your operating system and run the commands in your terminal.

10<div id="os" class="os">

11 <input type="radio" id="macos" name="os" checked>

12 <label for="macos">MacOS</label>

13 <div class="tab">

15```bash

16mkdir ~/urbit

17cd ~/urbit

18curl -JLO https://urbit.org/install/mac/latest

19tar zxvf ./darwin.tgz --strip=1

20~/urbit/urbit

21```

23 </div>

25 <input type="radio" id="linux" name="os">

26 <label for="linux">Linux</label>

27 <div class="tab">

29```shell

30mkdir ~/urbit

31cd ~/urbit

32wget --content-disposition https://urbit.org/install/linux64/latest

33tar zxvf ./linux64.tgz --strip=1

34~/urbit/urbit

35```

37Linux users may need to run this command in another terminal window to access your Urbit on port 80:

39```shell

40sudo apt-get install libcap2-bin

41sudo setcap 'cap_net_bind_service=+ep' ~/urbit/urbit

42```

44</div>

46 <input type="radio" id="windows" name="os">

47 <label for="windows">Windows</label>

48 <div class="tab">

50```winbatch

51mkdir %USERPROFILE%\urbit

52cd %USERPROFILE%\urbit

53curl -JLO https://urbit.org/install/windows/latest

54tar zxvf .\windows.tgz --strip=1

55%USERPROFILE%\urbit\urbit

56```

58> Windows 10 build 17063 and later includes the familiar `curl` and `tar` command-line tools.

60</div>

61</div>

63If successful, you will see a block of output beginning with the line:

65```

66Urbit: a personal server operating function

67```

69### Booting a free identity {#comet}

71There are two parts to Urbit: an **ID** and an **Operating System**.

73You have just installed the Operating System on your computer.

75The **ID** is similar to a username and password on another site. The difference is that the public part (the username) is verified by thousands of people around the world while only you hold the key (the password) to that ID.

77There are five kinds of Urbit IDs but to get started you only need to know about two: we call them **planets** and **comets**.

79---

81**Planets** are scarce (this prevents spamming, among other things) and usually require a price to acquire. This is the recommended way to run Urbit, but it's a bit more involved.

83A planet name looks like `~sampel-palnet`.

85[Follow this guide](/getting-started/) if you have already acquired a planet.

87[Find a planet to purchase](/getting-started/get-planet)

89---

91**Comets** are practically unlimited and free to acquire. At present, these are a great way to try out the network for free.

93A comet name looks like `~dasres-ragnep-lislyt-ribpyl--mosnyx-bisdem-nidful-marzod`.

95[Read more about Urbit ID here](/understanding-urbit/urbit-id)

97---

99To boot a comet, go into the command line and run the following command from the `urbit` directory you created during [Urbit installation](#os).

100

101```sh

102~/urbit/urbit -c mycomet

103```

104

105It may take a while to load the comet (probably only take a few minutes, but it could take longer). This comes along with it being free. When it's done you'll some messages ending like this:

106

107```

108ames: live on 31337

109http: web interface live on http://localhost:8080

110http: loopback live on http://localhost:12321

111~sampel_marzod:dojo>

112```

113

114When your comet is finished booting, you will see `~sampel_marzod:dojo>` (Dojo: the Urbit command line).

115

116To exit Urbit, use `Ctrl-D` or enter `|exit` into Dojo.

117

118To start your comet up again, run the following from your `urbit` directory (note the lack of `-c` argument):

119

120```sh

121~/urbit/urbit mycomet

122```

123

124### Using the web interface

125

126Urbit is an entirely new computer, so by default it drops you into the "dojo," which is its terminal. Like your current computer, it can be used to do just about anything if you know the right commands. You only need to know one command for now.

127

128At the moment, the most common way to use Urbit is by launching apps like Groups (a communications suite) from the web interface homescreen. The web interface allows you to use your ship without touching the terminal. You just need to get the password, or `code`, from the terminal.

129

1301. With your Urbit running, look for a line that says something like `http: web interface live on http://localhost:8080`. The number given is the port that your ship is using. It will most likely be 80 or 8080, but we're just making sure.

1312. If the port given is `80`, simply type `localhost` into your browser's address bar. If the given port is a different number, such as `8080`, you would type `localhost:8080`. You'll be met with a login prompt.

1323. In the window where you found the port number, type `+code` and press return. Copy-paste the code that appears into the "Access Key" field in the browser, and press continue.

1334. Once in, take a look around and try launching an app like Groups.

134

135## Next Steps

136

137### Updating your comet {#updating}

138

139Urbit comes with a recent release of the Urbit OS, but automatic updates of the `%base` desk (which contains the kernel of the OS) are not enabled by default for Comets. Many comets are used only once and thrown away, so it would be wasteful to update every single comet as soon as it boots. If you plan to use your comet for more than a quick test, you'll probably want to ensure you're running the latest version of the OS.

140

141You can enable updates for your comet by typing `|install (sein:title our now our) %kids, =local %base` into Dojo and pressing Enter.

142

143```

144> |install (sein:title our now our) %kids, =local %base

145>=

146kiln: activated install into %base from [~samzod %kids]

147kiln: downloading update for %base from [~samzod %kids]

148```

149

150### Read More about the Dojo {#the-dojo}

151

152The dojo is Urbit's command line. You can use it to control your ship, or to execute arbitrary code. Check out the links below for more information.

153

154- [Basic Operations](/using/os/getting-started)

155- [Basic Hoon](/docs/tutorials/hoon/hoon-school/setup)

156- [Glossary Entry](/docs/glossary/dojo)

157

158### Purchase a Permanent Identity {#boot-your-planet}

159

160You can continue using this comet indefinitely. There are currently few differences between using a comet-level identity and a planet-level one. However, some groups will not allow comets entry in order to maintain a certain level of quality, and changes may be made in the future that further devalue comets. They will always, however, be able to access the basic functions of the network.

161

162A comet also comes with a long and fairly unmemorable name whereas a planet has a short name and a "sigil" (avatar) associated with it that makes it more identifiable on the network. You may notice all this within the first few minutes of using Urbit.

163

164[For details of how to purchase a planet, visit this page](/getting-started/get-planet).

165

166<style>

167 .os {

168 display: flex;

169 flex-wrap: wrap;

170 }

171 .os label {

172 order: -1;

173 padding: .5rem;

174 min-width: 70px;