0xbbjubjub/miniguest
1
1
Fork 0
mirror of https://github.com/0xbbjubjub/miniguest.git synced 2024-09-11 05:55:35 +03:00
Code Issues Packages Projects Releases Wiki Activity
[UNMAINTAINED] lightweight NixOS images
68 Commits 6 Branches 7 Tags 408 KiB
C++ 53.7%
Nix 42.1%
Shell 2.5%
Meson 1.7%
5957d6a31b
Go to file
Louis Bettens 5957d6a31b ensure package source name is constant
2022-07-18 23:03:48 +02:00
.github add pull request template 2021-08-27 18:54:15 +02:00
checks add test 2021-12-28 17:35:29 +01:00
core core/qemu: auto-add necessary kernel modules 2022-07-18 23:03:48 +02:00
declarative add miniguest.<guest>.system 2021-12-28 17:35:29 +01:00
lib add flake-compat 2021-06-27 11:11:20 +02:00
template simplify template 2021-08-27 18:54:16 +02:00
tool ensure package source name is constant 2022-07-18 23:03:48 +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-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 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 add devShell 2021-06-27 11:11:20 +02:00
flake.nix refactor split flake 2021-08-27 18:54:16 +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 add flake-compat 2021-06-27 11:11:20 +02:00
USAGE.md update doc 2021-12-28 17:46:41 +01:00

README.md

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.

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.