0xbbjubjub/miniguest
1
1
Fork 0
mirror of https://github.com/0xbbjubjub/miniguest.git synced 2024-07-07 10:26:28 +03:00
Code Issues Packages Projects Releases Wiki Activity
[UNMAINTAINED] lightweight NixOS images
99 Commits 6 Branches 7 Tags 227 KiB
C++ 53.7%
Nix 42.1%
Shell 2.5%
Meson 1.7%
main
Go to file
Louis Bettens 77731cc5c1
README: add maintainer notice
2023-02-09 17:58:03 +01:00
.github tool: rewrite in C++ 2022-08-25 18:57:19 +02:00
checks checks: fix 2022-12-30 12:54:14 +01:00
core tool/create: take guest config into account 2022-08-25 18:57:19 +02:00
declarative chore: update flake schema 2022-08-25 18:57:19 +02:00
nix tool: rewrite in C++ 2022-08-25 18:57:19 +02:00
template chore: bump copyright year 2022-08-25 18:57:19 +02:00
tool tool: bump version 2022-12-08 18:27:38 +01: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 chore: bump copyright year 2022-08-25 18:57:19 +02:00
default.nix refactor nix flake 2022-07-18 23:03:48 +02:00
flake.lock flake.lock: Update 2022-12-08 18:27:33 +01:00
flake.nix ci: fix 2022-08-25 19:35:32 +02:00
INSTALL.md Add flake overlay instructions 2021-08-27 18:54:16 +02:00
README.md README: add maintainer notice 2023-02-09 17:58:03 +01: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

README.md

NOTICE: I have lost interest in this project

As of February 9th, 2023 I no longer rely on miniguest in production and don't actively maintain it. If you wish to take over, feel free.

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.