rpm-ostreed.conf - Man Page

/etc/rpm-ostreed.conf

This file configures the rpm-ostree daemon.

All options are configured in the "[Daemon]" section. Available options are:

AutomaticUpdatePolicy=

Controls the automatic update policy. Currently "none", "check", "stage", "apply". "none" disables automatic updates. "check" downloads just enough metadata to check for updates and display them in rpm-ostree status. Defaults to "none". The rpm-ostreed-automatic.timer(8) unit determines the actual frequency of updates.

The "stage" policy downloads and unpacks the update, queuing it for the next boot. This leaves initiating a reboot to other automation tools. Only a small amount of work is left to be performed at shutdown time via the ostree-finalize-staged.service systemd unit.

Finally, the "apply" policy will currently always initiate a reboot. However, in the future it may apply userspace-only fixes without a physical reboot. Any reboots initiated via rpm-ostree will default to honoring active systemd inhibitors. For example, to temporarily suppress automatic "apply" updates while debugging a system, you can use systemd-inhibit bash; exiting the shell will lift the inhibitor.

IdleExitTimeout=

Controls the time in seconds of inactivity before the daemon exits. Use 0 to disable auto-exit. Defaults to 60.

LockLayering=

Controls whether any mutation of the base OSTree commit is supported (for example, package overlays or overrides, initramfs overlays or regeneration). Defaults to false.

Recommends=

When layering, whether to install weak dependencies. Defaults to true.

Enabling the automatic updates "check" policy is a two step process. First, edit /etc/rpm-ostreed.conf to include AutomaticUpdatePolicy=check and then use rpm-ostree reload to reload the rpm-ostreed service. Next, enable the timer using systemctl enable rpm-ostreed-automatic.timer --now

When successful, the output from rpm-ostree status will display output similar to the following:

    $ rpm-ostree status
    State: idle; auto updates enabled (check; last run 22min ago)
    ...

rpm-ostree(1) rpm-ostreed-automatic.service(8) rpm-ostreed-automatic.timer(8)

rpm-ostree(1), rpm-ostreed-automatic.service(8).