# Frequently Asked Questions

As we receive questions we'll fill in the frequent ones here.

## How does `image-builder` fit into the Image Builder ecosystem?

The Image Builder team provides a bunch of tools that people can use to build, define, and customize operating system images. Amongst those are:

1. The [Image Builder service](https://console.redhat.com/insights/image-builder/) on the [Red Hat Console](https://console.redhat.com/) which lets users build images through an API or user interface, automatically upload images to their favorite hyperscalers. It integrates there with various other services such as custom content.
2. [osbuild-composer](https://github.com/osbuild/osbuild-composer) is the component that provides APIs for the [Image Builder service](https://console.redhat.com/insights/image-builder/) in such a way that you can host them locally.
3. [weldr-client](https://github.com/osbuild/weldr-client) is an application that uses the [osbuild-composer](https://github.com/osbuild/osbuild-composer) provided APIs to offer a local command line program to start, stop, and manage builds.

The above can be quite confusing, hence we've created `image-builder`. It allows you to do the same things as [weldr-client](https://github.com/osbuild/weldr-client) except it does so without the need to run [osbuild-composer](https://github.com/osbuild/osbuild-composer). Builds are done directly without going through other layers. This makes [image-builder](https://github.com/osbuild/image-builder-cli) easier to install and use in a lot of environments.

## Why does `image-builder` need `root` permissions?

For image types where we need to work with filesystems we need root. Mounting and working with filesystems is not namespaced in the Linux kernel and mounting filesystems is generally considered to be "running untrusted code in the kernel" hence it requires root permissions.

## Built-in distributions

- Fedora
- CentOS
- RHEL
- Alma Linux
- Alma Linux Kitten

## Image Types

The image types are defined in our [images](https://github.com/osbuild/images) repository.
An overview of which **image types** are available for which **distribution** can be found in
https://osbuild.org/docs/user-guide/image-descriptions/
