Environment variables

Several settings can be adjusted via environment variables. These can be specified either on the command line:

sudo raptor run -e OUTPUT_FORMAT=qcow2 ...

or in Raptor.toml:

[run.example-target]
target = "example"

# notice the `env.` prefix!
env.OUTPUT_FORMAT = "qcow2"

Environment reference

Variable	`deblive`	`live-disk-image`	`disk-image`	`part-image`
`GRUB_TIMEOUT`	✅	✅	❌	❌
`OUTPUT_FORMAT`	❌	✅	✅	✅
`EFI_MB`	❌	✅	✅	❌
`BOOT_MB`	❌	✅	✅	❌
`FREE_MB`	❌	✅	✅	✅
`USED_MB`	❌	✅	✅	✅
`SIZE_MB`	❌	✅	✅	✅

The auto-generated GRUB boot menu will use GRUB_TIMEOUT as the countdown until automatically booting the first target.

Setting this to 0 will boot without showing the GRUB menu.

Output format of the image. Common values include raw and qcow2.

See qemu-img --help for the complete list

Size of ESP, the EFI System Partition (/boot/efi).

Size of the boot partition (/boot)

How much free space to target in the resulting image.

Total disk space of all files in the root filesystem.

Calculated when building the image, unless specified manually.

The size of the resulting image.

Calculated as:

unless specified manually for exact control.