0xbbjubjub/miniguest
1
1
Fork 0
mirror of https://github.com/0xbbjubjub/miniguest.git synced 2024-08-15 17:00:43 +03:00
Code Issues Packages Projects Releases Wiki Activity
[UNMAINTAINED] lightweight NixOS images
69 Commits 6 Branches 7 Tags 408 KiB
C++ 53.7%
Nix 42.1%
Shell 2.5%
Meson 1.7%
6764080cc7
Go to file
Louis Bettens 6764080cc7 refactor nix flake
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
nix refactor nix flake 2022-07-18 23:03:48 +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 refactor nix flake 2022-07-18 23:03:48 +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 refactor nix flake 2022-07-18 23:03:48 +02:00
flake.lock refactor nix flake 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
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.