Urbit

The Urbit address space is now live on the Ethereum blockchain. We’re calling it ‘Azimuth’ and you can find it at 0x223c067f8cf28ae173ee5cafea60ca44c335fecb or azimuth.eth. Owners of Azimuth ‘points’ (galaxies, stars or planets) can use Bridge to manage them and view their balance now. Azimuth points can boot Arvo, the Urbit OS, with their Azimuth point.

Install instructions

To install and run Urbit please follow the instructions at urbit.org/docs/getting-started/. Packages and source tarballs are available there. You'll be on the live network in a few minutes.

If you're doing development on Urbit, keep reading.

Build instructions

External dependencies

vere, the Urbit virtual machine, depends on the following:

• C compiler (gcc or clang)
• Meson
• GMP
• OpenSSL
• libsigsegv
• libcurl
• libuv
• curses implementation (ncurses on Linux distributions, OS curses otherwise)

Most of these dependencies are unfortunate; we aim to drastically shrink the list in upcoming versions. vere proper makes use of GMP, OpenSSL, libcurl, and libsigsegv.

Building

Urbit uses Meson build system.

Some libraries which are not found in major distributions:

• ed25519
• libh2o
• murmur3
• softfloat3
• scrypt

are included as git submodules. To build urbit from source, perform the following steps:

Configuration & compilation

(For instructions for legacy meson, also see below)

1. Install all required dependencies.
2. Run ./scripts/bootstrap
3. Run ./scripts/build
4. The executable should appear in ./build directory.

Using meson & ninja

To configure the project, enter the build directory and enter meson configure -Dbuildtype=release. To compile a debug build of urbit, use meson configure -Dbuildtype=debug. To set a prefix for installation use meson configure -Dprefix=/usr.

Configuration & compilation for legacy meson

The syntax for legacy meson (Version 0.29) is a bit different.

1. Manually create build directory and invoke meson as meson . ./build
2. If you want to set options, this is done in one step. Use meson -D [options] . ./build to prepare customized build.

Once the project is configured, use ninja to build it. To install it into the default prefix, use ninja install. If you want to specify custom DESTDIR, use DESTDIR=... ninja install.

Contributing

Contributions of any form are more than welcome! If something doesn't seem right, and there is no issue about it yet, feel free to open one.

If you're looking to get involved, there are a few things you can do:

• Join the urbit-dev mailing list.
• Ask us about Hoon School, a course we run to teach the Hoon programming language and Urbit application development.
• Check out good contributor issues.
• Reach out to support@urbit.org to say hi and ask any questions you might have.

Once you've got your bearings, have a look at CONTRIBUTING.md for some pointers on setting up your development environment.