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 reboot either one of never, when-changed, when-needed, default: never
94 When the system should reboot following upgrades. never does not
96 reboot the system. when-changed triggers a reboot after any up‐
97 grade. when-needed triggers a reboot only when rebooting is nec‐
98 essary to apply changes, such as when systemd or the kernel is
99 upgraded.
100 reboot_command
102 string, default: shutdown -r +5 'Rebooting after applying pack‐
103 age updates'
104 Specify the command to run to trigger a reboot of the system.
106 For example, to skip the 5-minute delay and wall message, use
107 shutdown -r
108 [emitters] section
110 Choosing how the results should be reported.
111 emit_via
113 list, default: email, stdio, motd
114 List of emitters to report the results through. Available emit‐
116 ters are stdio to print the result to standard output, command
117 to send the result to a custom command, command_email to send an
118 email using a command, and email to send the report via email
119 and motd sends the result to /etc/motd file.
120 system_name
122 string, default: hostname of the given system
123 How the system is called in the reports.
125 send_error_messages
127 boolean, default: False
128 Invokes emitters when an error occurs.
130 [command] section
132 The command emitter configuration. Variables usable in format string
133 arguments are body with the message body.
134 command_format
136 format string, default: cat
137 The shell command to execute.
139 stdin_format
141 format string, default: {body}
142 The data to pass to the command on stdin.
144 [command_email] section
146 The command email emitter configuration. Variables usable in format
147 string arguments are body with message body, subject with email sub‐
148 ject, email_from with the "From:" address and email_to with a
149 space-separated list of recipients.
150 command_format
152 format string, default: mail -Ssendwait -s {subject} -r
153 {email_from} {email_to}
154 The shell command to execute.
156 email_from
158 string, default: root
159 Message's "From:" address.
161 email_to
163 list, default: root
164 List of recipients of the message.
166 stdin_format
168 format string, default: {body}
169 The data to pass to the command on stdin.
171 [email] section
173 The email emitter configuration.
174 email_from
176 string, default: root
177 Message's "From:" address.
179 email_host
181 string, default: localhost
182 Hostname of the SMTP server used to send the message.
184 email_port
186 integer, default: 25
187 Port number to connect to at the SMTP server.
189 email_tls
191 either one of no, yes, starttls, default: no
192 Whether to use TLS, STARTTLS or no encryption to connect to the
194 SMTP server.
195 email_to
197 list, default: root
198 List of recipients of the message.
200 [base] section
202 Can be used to override settings from DNF's main configuration file.
203 See DNF Configuration Reference.
204
206 See AUTHORS in DNF source distribution.
207
209 2012-2023, Red Hat, Licensed under GPLv2+
2104.18.2 Dec 08, 2023 DNF-AUTOMATIC(8)