Documentation
OSBuild consists of many different projects, each serving a particular purpose. This site tries to list all available documentation, tutorials, and resources available for the different osbuild projects:
- Image Builder: Product name around OSBuild, usually refers to the different web-interfaces for OSBuild.
- Composer: System and API services that orchestrate image build requests.
- osbuild: Execution engine that consumes image build descriptions and executes the related pipelines.
Image Builder
Image Builder is the product name around OSBuild. It consists of different user interfaces for OSBuild Composer. In most cases, the documentation of the respective user interface is the best source of help. Furthermore, the documentation of OSBuild Composer (see below) will provide insights into the internals of the image building tools.
- How Tos:
-
Development: @GitHub
-
Packages: The Image Builder project is pre-packaged for the following distributions:
- Fedora: rpms/cockpit-composer
Composer
OSBuild Composer is a project providing system services to build operating system images based on pre-defined, well-tested blueprints. The services provide OpenAPI-compatible interfaces, as well as integration with common user interfaces for linux systems including Cockpit.
-
Development: @GitHub
-
Packages: The OSBuild Composer project is pre-packaged for the following distributions:
- Fedora: rpms/osbuild-composer
osbuild
The osbuild project is the heart of OSBuild. It defines a pipeline description to build arbitrary operating system images out of many small and self-contained stages. Furthermore, it provides an execution engine that will consume a pipeline description, execute the pipeline, and provide the resulting image back to the user. The osbuild interfaces are meant to be used by machines, not humans. Therefore, access to osbuild resources should only be required if you plan to develop new osbuild frontends, debug osbuild failures on your own, or contribute to the osbuild development.
-
Development: @GitHub
-
Packages: The osbuild project is pre-packaged for the following distributions:
- Fedora: rpms/osbuild
- Arch Linux: AUR/osbuild
-
Manual Pages: All osbuild interfaces are documented in standard Linux Manual Pages. They are distributed together with osbuild, but their latest version can also be accessed online: