## Diskimage-builder Documentation

updated: 2018-03-01 11:27

# 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:

> - http://docs.openstack.org/releasenotes/diskimage-builder/

The code is available at:

> - https://git.openstack.org/cgit/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 freenode and on the `openstack-dev` mailing list (`openstack-dev@lists.openstack.org`).

## Table of Contents

- User Guide
  - Supported Distributions
  - Installation
  - Building An Image
  - Install Types
- Developer Guide
  - Design
  - Components
  - Developer Installation
  - Invocation
  - Caches and offline mode
  - Developing Elements
  - dib-lint
  - Stable Interfaces
  - Quickstart
  - Python module documentation
  - Finding Work
- Elements
  - apt-conf
  - apt-preferences
  - apt-sources
  - baremetal
  - base
  - bootloader
  - cache-url
  - centos-minimal
  - centos7
  - cleanup-kernel-initrd
  - cloud-init-datasources
  - cloud-init-disable-resizefs
  - cloud-init-nocloud
  - cloud-init
  - debian-minimal
  - debian-systemd
  - debian-upstart
  - debian
  - debootstrap
  - deploy-baremetal
  - deploy-kexec
  - deploy-targetcli
  - deploy-tgtadm
  - devuser
  - dhcp-all-interfaces
  - dib-init-system
  - dib-python
  - dib-run-parts
  - dkms
  - docker
  - dpkg
  - dracut-network
  - dracut-ramdisk
  - dracut-regenerate
  - dynamic-login
  - element-manifest
  - enable-serial-console
  - epel
  - fedora-minimal
  - fedora
  - Gentoo
  - growroot
  - grub2
  - hpdsa
  - hwburnin
  - hwdiscovery
  - ilo
  - install-bin
  - install-static
  - install-types
  - ironic-agent
  - iso
  - local-config
  - manifests
  - mellanox
  - modprobe-blacklist
  - no-final-image
  - oat-client
  - openssh-server
  - openstack-ci-mirrors
  - opensuse-minimal
  - opensuse
  - package-installs
  - pip-and-virtualenv
  - pip-cache
  - pkg-map
  - posix
  - proliant-tools
  - pypi
  - python-brickclient
  - ramdisk-base
  - ramdisk
  - rax-nova-agent
  - redhat-common
  - rhel-common
  - rhel7
  - runtime-ssh-host-keys
  - select-boot-kernel-initrd
  - selinux-permissive
  - simple-init
  - source-repositories
  - stable-interface-names
  - svc-map
  - sysctl
  - sysprep
  - uboot
  - ubuntu-common
  - ubuntu-core
  - ubuntu-minimal
  - ubuntu-signed
  - ubuntu
  - vm
  - yum-minimal
  - yum
  - zipl
  - zypper-minimal
  - zypper
- diskimage-builder Specifications
  - Overview
  - Specification review policies
  - Approved Specifications

updated: 2018-03-01 11:27

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 questions?