0xbbjubjub/miniguest
1
1
Fork 0
mirror of https://github.com/0xbbjubjub/miniguest.git synced 2025-01-06 03:45:49 +03:00
Code Issues Packages Projects Releases Wiki Activity
[UNMAINTAINED] lightweight NixOS images
55 Commits 6 Branches 7 Tags 422 KiB
C++ 53.7%
Nix 42.1%
Shell 2.5%
Meson 1.7%
doc-refresh
Go to file
Julie B. 44418b321f cleanup README
2021-08-27 17:50:06 +02:00
.github add pull request template 2021-08-24 10:33:46 +02:00
checks Remove storeCorruptionWarning 2021-08-24 13:09:03 +02:00
core Remove storeCorruptionWarning 2021-08-24 13:09:03 +02:00
declarative Add declarative miniguests 2021-08-11 09:58:56 +02:00
lib add flake-compat 2021-06-27 11:11:20 +02:00
miniguest Add create command 2021-08-24 13:09:03 +02:00
template Remove obsolete templates 2021-08-24 13:09:03 +02:00
.envrc add git hooks 2021-07-02 21:27:24 +02:00
.gitignore add defaultTemplate 2021-07-04 21:11:05 +02:00
CONTRIBUTING.md Add CONTRIBUTING.md 2021-08-25 22:27:14 +02:00
COPYING.GPL3 relicense 2021-08-06 21:50:56 +02:00
COPYING.ISC relicense 2021-08-06 21:50:56 +02:00
default.nix add nix-build compat 2021-07-02 21:27:24 +02:00
devshell.toml improve devShell 2021-07-04 17:11:21 +02:00
flake.lock squash! refactor into subflakes 2021-08-07 18:27:46 +02:00
flake.nix Add declarative miniguests 2021-08-11 09:58:56 +02:00
INSTALL.md cleanup README 2021-08-27 17:50:06 +02:00
README.md cleanup README 2021-08-27 17:50:06 +02:00
shell.nix add flake-compat 2021-06-27 11:11:20 +02:00
USAGE.md cleanup README 2021-08-27 17:50:06 +02:00

README.md

Low-footprint NixOS images

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.

Related work

  • 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.