1RPM-OSTREED.CONF(5) rpm-ostreed.conf RPM-OSTREED.CONF(5)
2
3
4
6 rpm-ostreed.conf - rpm-ostree daemon configuration file
7
9 /etc/rpm-ostreed.conf
10
12 This file configures the rpm-ostree daemon.
13
15 All options are configured in the "[Daemon]" section. Available options
16 are:
17
18 AutomaticUpdatePolicy=
19 Controls the automatic update policy. Currently "none", "check",
20 "stage", "apply". "none" disables automatic updates. "check"
21 downloads just enough metadata to check for updates and display
22 them in rpm-ostree status. Defaults to "none". The rpm-ostreed-
23 automatic.timer(8) unit determines the actual frequency of updates.
24
25 The "stage" policy downloads and unpacks the update, queuing it for
26 the next boot. This leaves initiating a reboot to other automation
27 tools. Only a small amount of work is left to be performed at
28 shutdown time via the ostree-finalize-staged.service systemd unit.
29
30 Finally, the "apply" policy will currently always initiate a
31 reboot. However, in the future it may apply userspace-only fixes
32 without a physical reboot. Any reboots initiated via rpm-ostree
33 will default to honoring active systemd inhibitors. For example, to
34 temporarily suppress automatic "apply" updates while debugging a
35 system, you can use systemd-inhibit bash; exiting the shell will
36 lift the inhibitor.
37
38 IdleExitTimeout=
39 Controls the time in seconds of inactivity before the daemon exits.
40 Use 0 to disable auto-exit. Defaults to 60.
41
42 LockLayering=
43 Controls whether any mutation of the base OSTree commit is
44 supported (for example, package overlays or overrides, initramfs
45 overlays or regeneration). Defaults to false.
46
48 Enabling the automatic updates "check" policy is a two step process.
49 First, edit /etc/rpm-ostreed.conf to include
50 AutomaticUpdatePolicy=check and then use rpm-ostree reload to reload
51 the rpm-ostreed service. Next, enable the timer using systemctl enable
52 rpm-ostreed-automatic.timer --now
53
54 When successful, the output from rpm-ostree status will display output
55 similar to the following:
56
57 $ rpm-ostree status
58 State: idle; auto updates enabled (check; last run 22min ago)
59 ...
60
61
63 rpm-ostree(1) rpm-ostreed-automatic.service(8) rpm-ostreed-
64 automatic.timer(8)
65
66
67
68rpm-ostree RPM-OSTREED.CONF(5)