An operating function
Go to file
Joe Bryan 7701b17995 Merge branch 'release/next-vere' into ipc-redux
* release/next-vere:
  noun: don't add identical values to song_x_cape's hashtable
  nix: fix boot-ship.nix
  release: urbit-os-v1.0.28
  vere: more readable http server status
  release: urbit-os-v1.0.27
  chat-store: don't trim on %messages, either
2020-07-20 13:22:20 -07:00
.github/ISSUE_TEMPLATE Update os1-bug-report.md 2020-06-03 17:38:21 -04:00
bin Merge branch 'master' into ipc-redux 2020-07-03 14:58:49 +02:00
doc/spec Misc cleanup blocking CC-Release. (#1249) 2019-04-24 17:27:27 -07:00
extras Misc cleanup blocking CC-Release. (#1249) 2019-04-24 17:27:27 -07:00
nix nix: fix boot-ship.nix 2020-07-14 16:13:15 -04:00
pkg Merge branch 'release/next-vere' into ipc-redux 2020-07-20 13:22:20 -07:00
sh Merge branch 'master' into jb/ipc-redux 2020-06-26 13:33:00 -07:00
.gitattributes gitattributes: export-ignore test directories [ci skip] 2020-02-01 12:07:13 +04:00
.gitignore gitignore: re-add mystery lines [ci skip] 2020-03-01 23:19:01 +04:00
.ignore Can now |hi to King Haskell over Ames! (and merged Master) 2019-07-31 22:16:02 -07:00
.mailmap mailmap: add pkova [ci skip] 2020-01-30 15:53:19 +04:00
.stylish-haskell.yaml stylish-haskell 2019-07-12 12:27:15 -07:00
.travis.yml ci: add travis as trusted user 2020-06-24 18:36:40 -07:00
CONTRIBUTING.md meta: update CONTRIBUTING, MAINTAINERS 2020-03-16 11:32:55 +04:00
default.nix Nix Build + Monorepo Structure (#1196) 2019-03-04 16:43:53 -08:00
LICENSE.txt Restore toplevel LICENSE.txt file. 2020-01-28 13:24:39 -08:00
MAINTAINERS.md maintainers: mention hotfixes can be pr'd to master 2020-05-08 11:05:34 -07:00
Makefile Build Linux static executables. (#2120) 2019-12-19 08:11:59 -08:00
README.md Updated nix install command 2020-07-02 20:05:59 -07:00

Urbit

A personal server operating function.

The Urbit address space, Azimuth, is now live on the Ethereum blockchain. You can find it at 0x223c067f8cf28ae173ee5cafea60ca44c335fecb or azimuth.eth. Owners of Azimuth points (galaxies, stars, or planets) can view or manage them using Bridge, and can also use them to boot Arvo, the Urbit OS.

Install

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

If you're interested in Urbit development, keep reading.

Development

Build Status

Urbit uses Nix to manage builds. On Linux and macOS you can install Nix via:

curl -L https://nixos.org/nix/install | sh

The Makefile in the project's root directory contains useful phony targets for building, installing, testing, and so on. You can use it to avoid dealing with Nix explicitly.

To build Urbit, for example, use:

make build

The test suite can similarly be run via a simple:

make test

Note that some of the Makefile targets need access to pills tracked via git LFS, so you'll also need to have those available locally:

git lfs install
git lfs pull

Contributing

Contributions of any form are more than welcome! Please take a look at our contributing guidelines for details on our git practices, coding styles, how we manage issues, and so on.

You might also be interested in: