Examples
========

distrobuilder supports creating lxc and Incus container images as well as Incus
VM images for a variety of different distros. There are several additional
options, including using a common cache directory for building variants of a
distro image.

After creation, the resulting images can then be imported into lxc or Incus.

Here are some simple examples demonstrating how to use distrobuilder:

Debian lxc container image
--------------------------

sudo distrobuilder build-lxc /usr/share/distrobuilder-images/debian.yaml ./lxc-trixie-image/ -o image.release=trixie

Debian Incus container image
----------------------------

sudo distrobuilder build-incus /usr/share/distrobuilder-images/debian.yaml ./incus-trixie-image/ -o image.release=trixie

Debian Incus VM image
---------------------

sudo distrobuilder build-incus --vm /usr/share/distrobuilder-images/debian.yaml ./incus-trixie-vm-image/ -o image.release=trixie

Creating other distro images
----------------------------

sudo distrobuilder build-incus /usr/share/distrobuilder-images/archlinux.yaml ./incus-arch-image/

sudo distrobuilder build-incus /usr/share/distrobuilder-images/fedora.yaml ./incus-fedora-image/ -o image.release=39

sudo distrobuilder build-incus /usr/share/distrobuilder-images/rockylinux.yaml ./incus-rocky-image/ -o image.release=9

sudo distrobuilder build-incus /usr/share/distrobuilder-images/ubuntu.yaml ./incus-ubuntu-image/ -o image.release=mantic