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 no‐
41 tify 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 ap‐
61 plied 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 network_online_timeout
75 time in seconds, default: 60
76 Maximal time dnf-automatic will wait until the system is online.
78 0 means that network availability detection will be skipped.
79 random_sleep
81 time in seconds, default: 0
82 Maximal random delay before downloading. Note that, by default,
84 the systemd timers also apply a random delay of up to 1 hour.
85 upgrade_type
87 either one of default, security, default: default
88 What kind of upgrades to look at. default signals looking for
90 all available updates, security only those with an issued secu‐
91 rity advisory.
92 [emitters] section
94 Choosing how the results should be reported.
95 emit_via
97 list, default: email, stdio, motd
98 List of emitters to report the results through. Available emit‐
100 ters are stdio to print the result to standard output, command
101 to send the result to a custom command, command_email to send an
102 email using a command, and email to send the report via email
103 and motd sends the result to /etc/motd file.
104 system_name
106 string, default: hostname of the given system
107 How the system is called in the reports.
109 [command] section
111 The command emitter configuration. Variables usable in format string
112 arguments are body with the message body.
113 command_format
115 format string, default: cat
116 The shell command to execute.
118 stdin_format
120 format string, default: {body}
121 The data to pass to the command on stdin.
123 [command_email] section
125 The command email emitter configuration. Variables usable in format
126 string arguments are body with message body, subject with email sub‐
127 ject, email_from with the "From:" address and email_to with a
128 space-separated list of recipients.
129 command_format
131 format string, default: mail -Ssendwait -s {subject} -r
132 {email_from} {email_to}
133 The shell command to execute.
135 email_from
137 string, default: root
138 Message's "From:" address.
140 email_to
142 list, default: root
143 List of recipients of the message.
145 stdin_format
147 format string, default: {body}
148 The data to pass to the command on stdin.
150 [email] section
152 The email emitter configuration.
153 email_from
155 string, default: root
156 Message's "From:" address.
158 email_host
160 string, default: localhost
161 Hostname of the SMTP server used to send the message.
163 email_to
165 list, default: root
166 List of recipients of the message.
168 [base] section
170 Can be used to override settings from DNF's main configuration file.
171 See conf_ref.
172
174 See AUTHORS in DNF source distribution.
175
177 2012-2021, Red Hat, Licensed under GPLv2+
1784.7.0 May 13, 2021 DNF-AUTOMATIC(8)