Clone this repo:

Branches

  1. 86f10e5 m/n/k/plugins/kvmdevice: allow everyone to access /dev/kvm by Jan Schär · 2 days ago main
  2. 4c4a704 build/http_archive_deb: introduce by Lorenz Brun · 7 days ago
  3. ddbb968 treewide: bump k8s to v0.34.1 by Tim Windelschmidt · 4 weeks ago
  4. 2137bd6 m/test/launch: reboot nodes instead of killing qemu by Tim Windelschmidt · 2 months ago
  5. 0f8ce4c m/node/allocs: split new package off m/node by Jan Schär · 9 weeks ago

Monogon Monorepo

This is the main repository containing the source code for the Monogon Platform.

This is pre-release software - take a look, and check back later! In the meantime, join us on Matrix (#monogon-os-community:matrix.org) or Discord.

Environment

Our build environment is self-contained and requires only minimal host dependencies:

  • A Linux machine or VM.
  • Bazelisk >= v1.15.0 (or a working Nix environment).
  • git to check out modules.
  • python3 to generate the workspace status to stamp.
  • A reasonably recent kernel, user namespaces are recommended for performance reasons.
  • Working KVM with access to /dev/kvm (if you want to run tests).

Our docs assume that Bazelisk is available as bazel on your PATH.

Refer to SETUP.md for detailed instructions.

Monogon OS

The source code lives in //metropolis (Metropolis is the codename of Monogon OS).

See the //metropolis/README.md for a developer quick start guide, or see the Monogon OS Handbook for user documentation.