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 dnf-automatic-notifyonly.timer && system‐
50 ctl start dnf-automatic-notifyonly.timer
51
53 The configuration file is separated into topical sections.
54 [commands] section
56 Setting the mode of operation of the program.
57 apply_updates
59 boolean, default: False
60 Whether packages comprising the available updates should be
62 applied by dnf-automatic.timer, i.e. installed via RPM. Implies
63 download_updates. Note that if this is set to False, downloaded
64 packages will be left in the cache till the next successful DNF
65 transaction. Note that the other timer units override this set‐
66 ting.
67 download_updates
69 boolean, default: False
70 Whether packages comprising the available updates should be
72 downloaded by dnf-automatic.timer. Note that the other timer
73 units override this setting.
74 upgrade_type
76 either one of default, security, default: default
77 What kind of upgrades to look at. default signals looking for
79 all available updates, security only those with an issued secu‐
80 rity advisory.
81 random_sleep
83 time in seconds, default: 0
84 Maximal random delay before downloading. Note that, by default,
86 the systemd timers also apply a random delay of up to 5 minutes.
87 [emitters] section
89 Choosing how the results should be reported.
90 emit_via
92 list, default: email, stdio, motd
93 List of emitters to report the results through. Available emit‐
95 ters are stdio to print the result to standard output, command
96 to send the result to a custom command, command_email to send an
97 email using a command, and email to send the report via email
98 and motd sends the result to /etc/motd file.
99 system_name
101 string, default: hostname of the given system
102 How the system is called in the reports.
104 [command] section
106 The command emitter configuration. Variables usable in format string
107 arguments are body with the message body.
108 command_format
110 format string, default: cat
111 The shell command to execute.
113 stdin_format
115 format string, default: {body}
116 The data to pass to the command on stdin.
118 [command_email] section
120 The command email emitter configuration. Variables usable in format
121 string arguments are body with message body, subject with email sub‐
122 ject, email_from with the "From:" address and email_to with a
123 space-separated list of recipients.
124 command_format
126 format string, default: mail -s {subject} -r {email_from}
127 {email_to}
128 The shell command to execute.
130 stdin_format
132 format string, default: {body}
133 The data to pass to the command on stdin.
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 [email] section
147 The email emitter configuration.
148 email_from
150 string, default: root
151 Message's "From:" address.
153 email_to
155 list, default: root
156 List of recipients of the message.
158 email_host
160 string, default: localhost
161 Hostname of the SMTP server used to send the message.
163 [base] section
165 Can be used to override settings from DNF's main configuration file.
166 See conf_ref.
167
169 See AUTHORS in DNF source distribution.
170
172 2012-2014, Red Hat, Licensed under GPLv2+
1734.2.5 May 07, 2019 DNF.AUTOMATIC(8)