MKG Cheat Sheet

MKG Cheatsheet

Running MKG with custom options
# mkg use_mkg_workflow=false [...]	Do not use preprocessed live install CD from
	Github Actions workflow. You may notably use:
	ncpus=X, bios, cflags, clonezilla_install
	debug_mode, elist, emirrors, kernel_config, mem,
	minimal, minimal_size, ncpus, nonroot_user
	passwd, processor, rootpasswd, stage3_tag
	vm_language.
	Main options:
	minimal: just build a minimal desktop.
	cflags=\'[...,...,...]\': CFLAGS options in list form.
	vm_language=..: set platform language if non US-English (fr, de, etc.)
# mkg use_clonezilla_workflow=false [...]	Do not use preprocessed cclonezilla live CD from Github Actions workflow.
	Rebuild this CD again incorporating VirtualBox
	from current Ubuntu repositories.

Supported desktops, init systems and profiles
$ git checkout [gnome or master]	Switch to Gnome/to Plasma
# mkg use_mkg_workflow=false stage3_tag=[hardened or systemd]	Switch to stable hardened profile / to gnome or plasma systemd profile

Input/Output and Backup options
$ mkg [...] burn	Burn Gentoo installer to DVD when processed.
# mkg [...] hot_install ext_device=sdX	Install Gentoo onto partition /dev/sdX after completion of VM processes.
# mkg from_device ext_device=sdX gentoo.iso	Backup partition /dev/sdX into a CloneZilla installer gentoo.iso
# mkg [...] from_iso gentoo.iso burn	Burn gentoo.iso to disk.
# mkg [...] from_iso gentoo.iso device_installer ext_device=sdX	Create USB stick or any block device installer from gentoo.iso
# mkg [...] from_vm vm=... gentoo.iso	Create CloneZilla installer image from VM (after VM completed processes and stopped.)
# mkg [...] from_vm vm=... hot_install ext_device=sdX	Directly install Gentoo to partition /dev/sdX from VM (after VM completed processes and stopped.)

Running MKG in containers
# mkg dockerize [gentoo.iso ...]	Running MKG in a Docker container. Followed by command line. Fetches back ISO installer if any.
$ git checkout gnome
# mkg dockerize [gentoo.iso...]	Running MKG in a Docker container for Gnome.
# docker exec -it ID bash	Check job log
cont# tail -f nohup.out
or:
grep -E '\[\w{3}\]' /var/log/syslog	Host log search. Also echoes container logs.
	Use syslog.x for older logs.
# docker cp ID:/mkg/gentoo.iso .	Fetch back MKG installer from container.

Graphic display and Interaction
$ mkg [...] gui=false	Do not display VirtualBox guest in GUI.
$ mkg [...] interactive=false	Do not interact with user. To be used in scripts and containers, with caution.
$ mkg [...] email=...@... \ email_passwd=...	Send a meesage to email address with given user password upon completion. Not to be used in public networks.

Reusing previously downloaded artifacts
$ mkg custom_clonezilla=file [...]	Use this file as CloneZilla live CD.
$ mkg download_clonezilla=false [...]	Use cached CloneZilla live CD from prior downloads.
$ mkg download_arch=false [...]	Use cached stage3 archive from prior downloads.
$ mkg download=false [...]	Use cached Gentoo minimal install CD from prior downloads.