1DNF-AUTOMATIC(8)                      DNF                     DNF-AUTOMATIC(8)
2
3
4

NAME

6       dnf-automatic - DNF Automatic
7

SYNOPSIS

9       dnf-automatic [<config file>]
10

DESCRIPTION

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
16       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
23       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
29       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
34       • dnf-automatic-notifyonly
35
36       • dnf-automatic-download
37
38       • dnf-automatic-install
39
40       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

RUN DNF-AUTOMATIC

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
49       For example: systemctl enable --now dnf-automatic-notifyonly.timer
50

CONFIGURATION FILE FORMAT

52       The configuration file is separated into topical sections.
53
54   [commands] section
55       Setting the mode of operation of the program.
56
57       apply_updates
58              boolean, default: False
59
60              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
67       download_updates
68              boolean, default: False
69
70              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
74       network_online_timeout
75              time in seconds, default: 60
76
77              Maximal time dnf-automatic will wait until the system is online.
78              0 means that network availability detection will be skipped.
79
80       random_sleep
81              time in seconds, default: 0
82
83              Maximal random delay before downloading.  Note that, by default,
84              the systemd timers also apply a random delay of up to 1 hour.
85
86       upgrade_type
87              either one of default, security, default: default
88
89              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
93   [emitters] section
94       Choosing how the results should be reported.
95
96       emit_via
97              list, default: email, stdio, motd
98
99              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
105       system_name
106              string, default: hostname of the given system
107
108              How the system is called in the reports.
109
110   [command] section
111       The command emitter configuration. Variables usable  in  format  string
112       arguments are body with the message body.
113
114       command_format
115              format string, default: cat
116
117              The shell command to execute.
118
119       stdin_format
120              format string, default: {body}
121
122              The data to pass to the command on stdin.
123
124   [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
130       command_format
131              format  string,  default:  mail  -Ssendwait  -s   {subject}   -r
132              {email_from} {email_to}
133
134              The shell command to execute.
135
136       email_from
137              string, default: root
138
139              Message's "From:" address.
140
141       email_to
142              list, default: root
143
144              List of recipients of the message.
145
146       stdin_format
147              format string, default: {body}
148
149              The data to pass to the command on stdin.
150
151   [email] section
152       The email emitter configuration.
153
154       email_from
155              string, default: root
156
157              Message's "From:" address.
158
159       email_host
160              string, default: localhost
161
162              Hostname of the SMTP server used to send the message.
163
164       email_to
165              list, default: root
166
167              List of recipients of the message.
168
169   [base] section
170       Can  be  used  to override settings from DNF's main configuration file.
171       See conf_ref.
172

AUTHOR

174       See AUTHORS in DNF source distribution.
175
177       2012-2021, Red Hat, Licensed under GPLv2+
178
179
180
181
1824.7.0                            May 13, 2021                 DNF-AUTOMATIC(8)
Impressum