A fancy wrapper around dnf --installroot, apt, pacman
and zypper that generates customized disk images with a number of
bells and whistles.
For a longer description and available features and options, see the man page.
You can install mkosi from your distribution with its package manager or the development version from git. The distribution packages are the preferred way to install mkosi.
The development version of mkosi might require tools from the systemd main
branch, see the action.yaml for what we currently use in CI.
If you just want to give the development version of mkosi a quick spin you can run
pipx install git+https://github.com/systemd/mkosi.gitwhich will transparently install mkosi into a Python virtual environment and a mkosi
binary to ~/.local/bin. This is, up to the path of the virtual environment and
the mkosi binary, equivalent to
python -m venv mkosivenv
mkosivenv/bin/pip install git+https://github.com/systemd/mkosi.git
# the mkosi binary is installed to mkosivenv/bin/mkosiIf you want to help develop mkosi you can run it from your clone of this repository by calling the module
python3 -m mkosiwhen you are in the repository top level.
To use your local mkosi checkout without being in the top level of the
repository you can either call the shim bin/mkosi or make an editable install
into a virtual environment. The MKOSI_INTERPRETER environment variable can be
set when using the bin/mkosi shim to configure the python interpreter used to
execute mkosi.
The shim can be symlinked somewhere into your PATH. To make an editable
install add --editable to either of the above examples using pip or pipx and
exchange the URL of the repository for the path to your local checkout, e.g
pipx install --editable path/to/yout/local/checkout