OS software update mixer


(C) 2018 Intel Corporation, CC-BY-SA-3.0

Manual section



mixer [subcommand] <flags>


mixer(1) is a software update generator that uses input RPMs and bundle definition files to create update metadata consumable by swupd(1).

mixer operates in a mix workspace using configuration files existing in the workspace. The tool allows users to use RPMs from an upstream URL (default download.clearlinux.org), provide their own RPMs, and use RPMs from other remote repositories to build updates. Users can also define their own local bundle definitions as well as use the default bundle definitions from the upstream URL.

mixer provides commands to manage local RPMs and bundle definitions and configure remote RPM repositories.

The output of mixer is a set of manifests readable by swupd as well as all the OS content swupd needs to perform its update operations. The OS content includes all the files in an update as well as zero- and delta-packs for improved update performance. The content that mixer produces is tied to a specific format so that swupd is guaranteed to understand it if the client is using the right version of swupd. See swupd(1) and os-format(7) for more details.


The following options are applicable to most subcommands, and can be used to modify the core behavior and resources that mixer uses.

  • -h, --help

    Display general help information. If put after a subcommand, it will display help specific to that subcommand.

  • --check

    Check all external dependencies needed by mixer.

  • -v, --version

    Displays the version information of the mixer program and exit.

  • --offline

    Skip caching upstream bundles and work entirely with local bundles. Do not reach out over network to perform operations.



Add RPMs from the configured LOCAL_RPM_DIR to the local dnf repository. See mixer.add-rpms(1) for more details.


Build various pieces of OS content, including all metadata needed by swupd to perform updates. mixer build is a complicated tool in itself. See mixer.build(1) for more details.


Perform various configuration actions on local and upstream bundles. The user can add or remove bundles from their mix, create new bundle definitions, or validate local bundle definition files. See mixer.bundle(1) for more details.


Perform configuration related actions, including configuration file validation and conversion from deprecated formats. See mixer.config(1) for more details.


Print help text for any mixer subcommand.


Initialize mixer configuration and workspace. See mixer.init(1) for more details.


Add, list, remove, or edit RPM repositories to be used by mixer. This subcommand allows users to configure which remote or local repositories mixer should use to look for RPMs. See mixer.repo(1) for more information.


Manage mix and upstream versions. By itself the command will print the current version of mix and upstream, and also report the latest version of upstream available. Also allows the user to update mix and upstream versions. See mixer.versions(1) for more details.



The mixer configuration file.


The default location for the DNF configuration file.