[UNMAINTAINED] lightweight NixOS images
Go to file
2022-08-25 18:57:19 +02:00
.github tool: rewrite in C++ 2022-08-25 18:57:19 +02:00
checks tool: rewrite in C++ 2022-08-25 18:57:19 +02:00
core core/qemu: add virtiofs support 2022-08-08 15:14:34 +02:00
declarative declarative: avoid deprecated nixpkgs.initialSystem 2022-07-18 23:03:48 +02:00
nix tool: rewrite in C++ 2022-08-25 18:57:19 +02:00
template simplify template 2021-08-27 18:54:16 +02:00
tool tool: rewrite in C++ 2022-08-25 18:57:19 +02:00
.envrc refactor nix flake 2022-07-18 23:03:48 +02:00
.gitignore tool: rewrite in C++ 2022-08-25 18:57:19 +02:00
CONTRIBUTING.md Add CONTRIBUTING.md 2021-08-27 18:54:15 +02:00
COPYING.GPL3 relicense 2021-08-27 18:53:58 +02:00
COPYING.ISC relicense 2021-08-27 18:53:58 +02:00
default.nix refactor nix flake 2022-07-18 23:03:48 +02:00
flake.lock flake.lock: Update 2022-07-18 23:03:48 +02:00
flake.nix refactor nix flake 2022-07-18 23:03:48 +02:00
INSTALL.md Add flake overlay instructions 2021-08-27 18:54:16 +02:00
README.md Add shields to readme 2022-07-18 22:49:33 +02:00
shell.nix refactor nix flake 2022-07-18 23:03:48 +02:00
Taskfile.yaml tool: rewrite in C++ 2022-08-25 18:57:19 +02:00
USAGE.md update doc 2021-12-28 17:46:41 +01:00

Low-footprint NixOS images

Latest release License

GitHub contributors GitHub Repo stars

Miniguest makes lightweight NixOS guest images for popular virtualisation tools. The guest systems live entirely on the host's Nix store. The host system does not need to be NixOS.

How lightweight?

Lighter than if it were the host system. There is no disk image, no bootloader, no ISO. Just plain immutable files that are friendly to Nix's deduplication mechanisms.

Getting started

You can read the Installation guide, then the Usage guide.

Support Vector

QEMU virtual machines and Linux containers are supported.

For VMs, Libvirt integration is present. For containers, Miniguest can produce templates in LXC format.

  • nixos-container: Miniguest takes inspiration from NixOS's containers, however, containers wraps systemd-nspawn, whereas Miniguest delegates container management to any supported hypervisor.

  • nixos-rebuild build-vm: Miniguest borrows the store-sharing mechanism from NixOS's built-in lightweight QEMU VMs when applicable, but it lets a framework take care of the VM configuration and lifecycle.