This tool is used to build Ubuntu images. Currently builds Ubuntu Core snap-based images from model assertions and Ubuntu classic preinstalled images using image definition files, but it will be generalized to build more (eventually all) Ubuntu images.

Ubuntu 18.04 (Bionic Beaver) is the minimum platform requirement, but Ubuntu 20.04 (Focal Fossa) or newer is recommended. All required third party packages are available in the Ubuntu archive.

If you want to run the test suite locally, you should install all the build dependencies named in the debian/control file. The easiest way to do that is to run::

$ sudo apt build-dep ./

from the directory containing the debian subdirectory. Alternatively of course, you can just install the packages named in the Build-Depends field.

• Project home: https://github.com/Canonical/ubuntu-image
• Report bugs at: https://bugs.launchpad.net/ubuntu-image
• Git clone: https://github.com/Canonical/ubuntu-image.git
• Manual page: man ubuntu-image (https://github.com/Canonical/ubuntu-image/blob/main/ubuntu-image.rst)

The "gadget.yaml" specification has moved to the snapcraft forum

• Ensure golang >= 1.21 is installed
• Clone the git repository using git clone https://github.com/canonical/ubuntu-image.git
• cd into the newly cloned repository
• Run go build -o . ./...
• The newly compiled executable ubuntu-image will be created in the current directory