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
75 Commits 6 Branches 7 Tags 422 KiB
C++ 53.7%
Nix 42.1%
Shell 2.5%
Meson 1.7%
wip
Go to file
Julie B. f0eb5c1cfc wip
2022-07-26 09:57:14 +02:00
.github add pull request template 2021-08-27 18:54:15 +02:00
checks tool: init cpp rewrite 2022-07-03 21:56:59 +02:00
core core/qemu: auto-add necessary kernel modules 2022-02-13 10:39:28 +01:00
declarative declarative: avoid deprecated nixpkgs.initialSystem 2022-06-13 21:05:26 +02:00
nix tool: init cpp rewrite 2022-07-03 21:56:59 +02:00
template simplify template 2021-08-27 18:54:16 +02:00
tool wip 2022-07-26 09:57:14 +02:00
.envrc refactor nix flake 2022-04-23 19:24:10 +02:00
.gitignore tool: init cpp rewrite 2022-07-03 21:56:59 +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-04-23 19:24:10 +02:00
flake.lock flake.lock: Update 2022-06-03 23:22:09 +02:00
flake.nix refactor nix flake 2022-04-23 19:24:10 +02:00
INSTALL.md Add flake overlay instructions 2021-08-27 18:54:16 +02:00
README.md cleanup README 2021-08-27 18:54:15 +02:00
shell.nix refactor nix flake 2022-04-23 19:24:10 +02:00
Taskfile.yaml tool: init cpp rewrite 2022-07-03 21:56:59 +02:00
USAGE.md update doc 2021-12-28 17:46:41 +01: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.