mirror of https://github.com/nix-community/nixos-generators.git synced 2024-09-11 12:15:29 +03:00

Collection of image builders [maintainer=@Lassulus]

Go to file

lassulus 942930d595 find runner in /bin of output		2019-01-22 07:38:54 +01:00
formats	formats vm-nogui: resize on login	2019-01-17 22:01:05 +01:00
.gitignore	add .gitignore	2018-08-11 20:40:57 +02:00
config.nix	initial commit	2018-04-28 12:17:58 +02:00
default.nix	make nixos-generators installable	2019-01-22 00:19:28 +00:00
eval-format.nix	central command (#8 )	2019-01-17 15:18:00 +01:00
LICENSE	add license	2019-01-17 17:38:32 +01:00
Makefile	make nixos-generators installable	2019-01-22 00:19:28 +00:00
nixos-generate	find runner in /bin of output	2019-01-22 07:38:54 +01:00
README.md	make nixos-generators installable	2019-01-22 00:19:28 +00:00

nixos-generators - one config, multiple formats

The nixos-generators project allows to take the same NixOS configuration, and generate outputs for different target formats.

Just put your stuff into the config.nix and then call one of the image builders.

for example:

./nixos-generate -f iso

./nixos-generate -f iso -c /etc/nixos/configuration.nix

it echoes the path to a iso image, which you then can flash onto an usb-stick or mount & boot in a virtual machine.

Installation

nixos-generators can be installed from source into the user profile like this:

$ nix-env -f https://github.com/nix-community/nixos-generators/archive/master.tar.gz -i

format	description
gce	Google Compute Image
install-iso	Installer ISO
iso	ISO
kexec	kexec tarball (extract to / and run /kexec_nixos)
kexec-bundle	same as before, but it's just an executable
openstack	qcow2 image for openstack
qcow2	qcow2 image
raw	raw image
virtualbox	virtualbox VM
vm	only used as a qemu-kvm runner
vm-nogui	same as before, but without a GUI

Run ./nixos-generate --help for detailed usage information

This project is licensed under the terms of the MIT license.