distrobuilder
System container and VM image builder for LXC and LXD
Status
| Type | Service | Status |
|---|---|---|
| CI | GitHub |  |
| Project status | CII Best Practices |
Command line options
The following are the command line options of distrobuilder. You can use distrobuilder to create container images for both LXC and LXD.
$ distrobuilder
System container and VM image builder for LXC and LXD
Usage:
distrobuilder [command]
Available Commands:
build-dir Build plain rootfs
build-lxc Build LXC image from scratch
build-lxd Build LXD image from scratch
help Help about any command
pack-lxc Create LXC image from existing rootfs
pack-lxd Create LXD image from existing rootfs
repack-windows Repack Windows ISO with drivers included
Flags:
--cache-dir Cache directory
--cleanup Clean up cache directory (default true)
--debug Enable debug output
--disable-overlay Disable the use of filesystem overlays
-h, --help help for distrobuilder
-o, --options Override options (list of key=value)
-t, --timeout Timeout in seconds
--version Print version number
Use "distrobuilder [command] --help" for more information about a command.
Installing from package
distrobuilder is available from the Snap Store.
sudo snap install distrobuilder --classic
Installing from source
To compile distrobuilder from source, first install the Go programming language, and some other dependencies.
- Debian-based:
sudo apt update sudo apt install -y golang-go debootstrap rsync gpg squashfs-tools git - ArchLinux-based:
sudo pacman -Syu sudo pacman -S go debootstrap rsync gnupg squashfs-tools git --needed
Second, download the source code of the distrobuilder repository (this repository).
git clone https://github.com/lxc/distrobuilder
Third, enter the directory with the source code of distrobuilder and run make to compile the source code. This will generate the executable program distrobuilder, and it will be located at $HOME/go/bin/distrobuilder.
cd ./distrobuilder
make
Finally, you can run distrobuilder as follows. You may also add to your $PATH the directory $HOME/go/bin/ so that you do not need to run the command with the full path.
$HOME/go/bin/distrobuilder
How to use
See How to use distrobuilder for instructions.