Skip to content

tew42/distrobuilder

This branch is 190 commits behind lxc/distrobuilder:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

04f5021 · Oct 16, 2023
Aug 8, 2023
Sep 5, 2023
Oct 16, 2023
Oct 16, 2023
Oct 16, 2023
Oct 16, 2023
Oct 16, 2023
Oct 16, 2023
Oct 16, 2023
Apr 24, 2023
Feb 15, 2018
Apr 25, 2022
Feb 19, 2023
Apr 24, 2023
Feb 6, 2018
Jul 6, 2023
Jul 22, 2019
Feb 6, 2018
Jun 21, 2023
Sep 5, 2023
Oct 16, 2023
Oct 16, 2023
Jun 22, 2023

Repository files navigation

distrobuilder

System container and VM image builder for Incus and LXC.

Incus images may also be compatible with Canonical's LXD.

Status

Type Service Status
CI GitHub Build Status
Project status CII Best Practices 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 Incus and LXC.

$ distrobuilder
System container and VM image builder for Incus and LXC

Usage:
  distrobuilder [command]

Available Commands:
  build-dir      Build plain rootfs
  build-incus    Build Incus image from scratch
  build-lxc      Build LXC image from scratch
  help           Help about any command
  pack-incus     Create Incus image from existing rootfs
  pack-lxc       Create LXC 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.

Troubleshooting

See Troubleshoot distrobuilder.

About

System container image builder for LXC and LXD

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 94.2%
  • HTML 1.8%
  • Python 1.1%
  • CSS 0.8%
  • JavaScript 0.8%
  • Shell 0.6%
  • Other 0.7%