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
41       notify 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 dnf-automatic-notifyonly.timer && system‐
50       ctl start dnf-automatic-notifyonly.timer
51

CONFIGURATION FILE FORMAT

53       The configuration file is separated into topical sections.
54
55   [commands] section
56       Setting the mode of operation of the program.
57
58       apply_updates
59              boolean, default: False
60
61              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
68       download_updates
69              boolean, default: False
70
71              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
75       upgrade_type
76              either one of default, security, default: default
77
78              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
82       random_sleep
83              time in seconds, default: 0
84
85              Maximal random delay before downloading.  Note that, by default,
86              the systemd timers also apply a random delay of up to 5 minutes.
87
88   [emitters] section
89       Choosing how the results should be reported.
90
91       emit_via
92              list, default: email, stdio, motd
93
94              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
100       system_name
101              string, default: hostname of the given system
102
103              How the system is called in the reports.
104
105   [command] section
106       The command emitter configuration. Variables usable  in  format  string
107       arguments are body with the message body.
108
109       command_format
110              format string, default: cat
111
112              The shell command to execute.
113
114       stdin_format
115              format string, default: {body}
116
117              The data to pass to the command on stdin.
118
119   [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
125       command_format
126              format  string,  default:  mail  -s  {subject}  -r  {email_from}
127              {email_to}
128
129              The shell command to execute.
130
131       stdin_format
132              format string, default: {body}
133
134              The data to pass to the command on stdin.
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   [email] section
147       The email emitter configuration.
148
149       email_from
150              string, default: root
151
152              Message's "From:" address.
153
154       email_to
155              list, default: root
156
157              List of recipients of the message.
158
159       email_host
160              string, default: localhost
161
162              Hostname of the SMTP server used to send the message.
163
164   [base] section
165       Can  be  used  to override settings from DNF's main configuration file.
166       See conf_ref.
167

AUTHOR

169       See AUTHORS in DNF source distribution.
170
172       2012-2019, Red Hat, Licensed under GPLv2+
173
174
175
176
1774.2.17                           Nov 29, 2019                 DNF-AUTOMATIC(8)
Impressum