Imagecraft is the command-line tool for building bootable disk images. It declares an
image's structure, contents, and build details in a project file named
imagecraft.yaml.
In your project directory, create a minimal project file with:
imagecraft initAfter declaring your image's essential details, pack it with:
imagecraft packIf you want to learn more about this workflow by working directly with the tool, follow along with the Build an Ubuntu image tutorial.
Imagecraft is available on all snap-ready Linux distributions.
sudo snap install imagecraft --classicThe Imagecraft documentation provides guidance and learning material about the full process of crafting images, installing additional software, and configuring instances.
Ask your questions about Imagecraft and see who's working on what in the Imagecraft Matrix channel.
You can report any issues or bugs on the project's GitHub repository.
Imagecraft is covered by the Ubuntu Code of Conduct.
Imagecraft is open source and part of the Canonical family. We would love your help.
If you're interested, start with the contribution guide.
We welcome any suggestions and help with the docs. The Canonical Open Documentation Academy is the hub for doc development, including Imagecraft docs. No prior coding experience is required.
Imagecraft is released under the GPL-3.0 license.
© 2023-2025 Canonical Ltd.