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 --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
61              applied 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       upgrade_type
75              either one of default, security, default: default
76
77              What kind of upgrades to look at. default  signals  looking  for
78              all  available updates, security only those with an issued secu‐
79              rity advisory.
80
81       random_sleep
82              time in seconds, default: 0
83
84              Maximal random delay before downloading.  Note that, by default,
85              the systemd timers also apply a random delay of up to 5 minutes.
86
87   [emitters] section
88       Choosing how the results should be reported.
89
90       emit_via
91              list, default: email, stdio, motd
92
93              List  of emitters to report the results through. Available emit‐
94              ters are stdio to print the result to standard  output,  command
95              to send the result to a custom command, command_email to send an
96              email using a command, and email to send the  report  via  email
97              and motd sends the result to /etc/motd file.
98
99       system_name
100              string, default: hostname of the given system
101
102              How the system is called in the reports.
103
104   [command] section
105       The  command  emitter  configuration. Variables usable in format string
106       arguments are body with the message body.
107
108       command_format
109              format string, default: cat
110
111              The shell command to execute.
112
113       stdin_format
114              format string, default: {body}
115
116              The data to pass to the command on stdin.
117
118   [command_email] section
119       The command email emitter configuration.  Variables  usable  in  format
120       string  arguments  are  body with message body, subject with email sub‐
121       ject,  email_from  with  the  "From:"  address  and  email_to  with   a
122       space-separated list of recipients.
123
124       command_format
125              format  string,  default:  mail  -s  {subject}  -r  {email_from}
126              {email_to}
127
128              The shell command to execute.
129
130       stdin_format
131              format string, default: {body}
132
133              The data to pass to the command on stdin.
134
135       email_from
136              string, default: root
137
138              Message's "From:" address.
139
140       email_to
141              list, default: root
142
143              List of recipients of the message.
144
145   [email] section
146       The email emitter configuration.
147
148       email_from
149              string, default: root
150
151              Message's "From:" address.
152
153       email_to
154              list, default: root
155
156              List of recipients of the message.
157
158       email_host
159              string, default: localhost
160
161              Hostname of the SMTP server used to send the message.
162
163   [base] section
164       Can be used to override settings from DNF's  main  configuration  file.
165       See conf_ref.
166

AUTHOR

168       See AUTHORS in DNF source distribution.
169
171       2012-2020, Red Hat, Licensed under GPLv2+
172
173
174
175
1764.2.21                           Apr 08, 2020                 DNF-AUTOMATIC(8)
Impressum