on bb3adff help sign in
64 lines 2.2 kB history raw
1+++
2title = "Environment Setup"
3description = "How to set up an environment for Urbit development."
4weight = 11
5template = "doc.html"
6+++
8This guide covers best practices for preparing your environment to develop
9within the Urbit ecosystem.
11## Creating a development ship
13To do work with Hoon, we recommended using a "fake" ship -- one that's not
14connected to the network.
16Because such a ship has no presence on the network, you don't need an Azimuth
17identity. You just need to have [installed the Urbit binary](/getting-started/cli).
19To create a fake ship named `~zod`, run the command below. You can replace `zod`
20with any valid Urbit ship-name.
22```
23./urbit -F zod
24```
26This should take a couple of minutes, during which you should see a block of boot
27messages, starting with the Urbit version number.
29## Hoon support in text editors
31A variety of plugins have been built to provide support for the Hoon language in
32different text editors:
34#### Atom
36Atom is free and open-source and runs on all major operating systems. It is
37available [here](https://atom.io/). A package for Hoon support is maintained by
38Tlon and may be obtained using the package manager within the editor by
39searching for `Hoon`.
41#### Sublime Text
43Sublime Text is closed-source, but may be downloaded for free and there is no
44enforced time limit for evaluation. It runs on all major operating systems. It
45is available [here](https://www.sublimetext.com/).
47#### Visual Studio Code
49Visual Studio Code is free and open-source and runs on all major operating
50systems. It is available [here](https://code.visualstudio.com/). Hoon support
51may be acquired in the Extensions menu within the editor by searching for
52`Hoon`.
54#### Emacs
56Emacs is free and open-source and runs on all major operating systems. It is
57available [here](https://www.gnu.org/software/emacs/). Hoon support is available
58with [hoon-mode.el](https://github.com/urbit/hoon-mode.el).
60#### Vim
62Vim is free and open-source and runs on all major operating systems. It is
63available [here](https://www.vim.org/). Hoon support is available with
64[hoon.vim](https://github.com/urbit/hoon.vim) and is maintained by Tlon.