1DNF-AUTOMATIC(8) DNF DNF-AUTOMATIC(8)
2
6 dnf-automatic - DNF Automatic
7
9 dnf-automatic [<config file>]
10
12 Alternative CLI to dnf upgrade with specific facilities to make it
13 suitable to be executed automatically and regularly from systemd
14 timers, cron jobs and similar.
15 The operation of the tool is usually controlled by the configuration
17 file or the function-specific timer units (see below). The command only
18 accepts a single optional argument pointing to the config file, and
19 some control arguments intended for use by the services that back the
20 timer units. If no configuration file is passed from the command line,
21 /etc/dnf/automatic.conf is used.
22 The tool synchronizes package metadata as needed and then checks for
24 updates available for the given system and then either exits, downloads
25 the packages or downloads and applies the packages. The outcome of the
26 operation is then reported by a selected mechanism, for instance via
27 the standard output, email or MOTD messages.
28 The systemd timer unit dnf-automatic.timer will behave as the configu‐
30 ration file specifies (see below) with regard to whether to download
31 and apply updates. Some other timer units are provided which override
32 the configuration file with some standard behaviours:
33 · dnf-automatic-notifyonly
35 · dnf-automatic-download
37 · dnf-automatic-install
39 Regardless of the configuration file settings, the first will only
41 notify of available updates. The second will download, but not install
42 them. The third will download and install them.
43
45 You can select one that most closely fits your needs, customize
46 /etc/dnf/automatic.conf for any specific behaviors, and enable the
47 timer unit.
48 For example: systemctl enable --now dnf-automatic-notifyonly.timer
50
52 The configuration file is separated into topical sections.
53 [commands] section
55 Setting the mode of operation of the program.
56 apply_updates
58 boolean, default: False
59 Whether packages comprising the available updates should be
61 applied by dnf-automatic.timer, i.e. installed via RPM. Implies
62 download_updates. Note that if this is set to False, downloaded
63 packages will be left in the cache till the next successful DNF
64 transaction. Note that the other timer units override this set‐
65 ting.
66 download_updates
68 boolean, default: False
69 Whether packages comprising the available updates should be
71 downloaded by dnf-automatic.timer. Note that the other timer
72 units override this setting.
73 upgrade_type
75 either one of default, security, default: default
76 What kind of upgrades to look at. default signals looking for
78 all available updates, security only those with an issued secu‐
79 rity advisory.
80 random_sleep
82 time in seconds, default: 0
83 Maximal random delay before downloading. Note that, by default,
85 the systemd timers also apply a random delay of up to 5 minutes.
86 [emitters] section
88 Choosing how the results should be reported.
89 emit_via
91 list, default: email, stdio, motd
92 List of emitters to report the results through. Available emit‐
94 ters are stdio to print the result to standard output, command
95 to send the result to a custom command, command_email to send an
96 email using a command, and email to send the report via email
97 and motd sends the result to /etc/motd file.
98 system_name
100 string, default: hostname of the given system
101 How the system is called in the reports.
103 [command] section
105 The command emitter configuration. Variables usable in format string
106 arguments are body with the message body.
107 command_format
109 format string, default: cat
110 The shell command to execute.
112 stdin_format
114 format string, default: {body}
115 The data to pass to the command on stdin.
117 [command_email] section
119 The command email emitter configuration. Variables usable in format
120 string arguments are body with message body, subject with email sub‐
121 ject, email_from with the "From:" address and email_to with a
122 space-separated list of recipients.
123 command_format
125 format string, default: mail -s {subject} -r {email_from}
126 {email_to}
127 The shell command to execute.
129 stdin_format
131 format string, default: {body}
132 The data to pass to the command on stdin.
134 email_from
136 string, default: root
137 Message's "From:" address.
139 email_to
141 list, default: root
142 List of recipients of the message.
144 [email] section
146 The email emitter configuration.
147 email_from
149 string, default: root
150 Message's "From:" address.
152 email_to
154 list, default: root
155 List of recipients of the message.
157 email_host
159 string, default: localhost
160 Hostname of the SMTP server used to send the message.
162 [base] section
164 Can be used to override settings from DNF's main configuration file.
165 See conf_ref.
166
168 See AUTHORS in DNF source distribution.
169
171 2012-2020, Red Hat, Licensed under GPLv2+
1724.2.21 Apr 08, 2020 DNF-AUTOMATIC(8)