# Diskimage-builder Documentation

`diskimage-builder` is a tool for automatically building customized operating-system images for use in clouds and other environments.

It includes support for building images based on many major distributions and can produce cloud-images in all common formats (`qcow2`, `vhd`, `raw`, etc), bare metal file-system images and ram-disk images. These images are composed from the many included `elements`; `diskimage-builder` acts as a framework to easily add your own elements for even further customization.

`diskimage-builder` is used extensively by the TripleO project and within OpenStack Infrastructure.

## Code

Release notes for the latest and previous versions are available at:

- https://docs.openstack.org/releasenotes/diskimage-builder/

The code is available at:

- https://opendev.org/openstack/diskimage-builder/

## Issues

Issues are tracked on launchpad at:

- https://bugs.launchpad.net/diskimage-builder/+bugs

## Communication

Communication among the diskimage-builder developers happens on IRC in `#openstack-dib` on OFTC and on the `openstack-discuss` mailing list (`openstack-discuss@lists.openstack.org`).

## Table of Contents

- User Guide
  - Supported Distributions
  - Installation
  - Building An Image
  - Install Types
- Developer Guide
  - Design
  - Components
  - Developer Installation
  - Caches and offline mode
  - Developing Elements
  - dib-lint
  - Stable Interfaces
  - vhd creation
  - qemu patch
  - Module index
  - Quickstart
  - Python module documentation
  - Finding Work
- Elements
- diskimage-builder Specifications
  - Overview
  - Specification review policies
  - Approved Specifications

this page last updated: 2022-01-12 16:32:54

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug