1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
.TH "UPGRADE\-SYSTEM.CONF" "5" "2025-09-17" "https://tracker.debian.org/pkg/upgrade-system" "Debian GNU/Linux"
.SH "NAME"
upgrade\-system.conf \- Configuration file for
.BR upgrade\-system (8)
.SH "DESCRIPTION"
.BR upgrade\-system.conf
is the configuration file for the
.BR upgrade\-system (8)
Debian administration utility. This file specifies command options used
for calling
.BR apt\-get (8)
and
.BR deborphan (1)
within
.BR upgrade\-system (8).
.PP
Lines starting with a hash mark ("#") and empty lines are ignored.
.SH "ENVIRONMENT"
The configuration file may contain any of these environment variables:
.SS UPDATEOPTS
This variable specifies the
.BR apt\-get (8)
options to use with the
.BR update
command. Built-in defaults are:
.PP
UPDATEOPTS="\-\-quiet \-\-quiet \-\-yes \-\-allow\-releaseinfo\-change\-codename \-\-allow\-releaseinfo\-change\-version"
.PP
Consult the
.BR apt\-get (8)
manual page to check which options are available for any
particular version, before setting this variable.
.SS UPGRADEOPTS
This variable specifies which one of
.BR dist-upgrade
or
.BR upgrade
to execute as the
.BR apt\-get (8)
upgrade command and the command options. Built-in defaults are:
.PP
UPGRADEOPTS="\-\-purge \-\-option APT::Get::Build\-Dep\-Automatic=true \-\-auto\-remove \-\-fix-broken dist\-upgrade"
.PP
Consult the
.BR apt\-get (8)
manual page to check which options are available for any
particular version, before setting this variable.
.SS ORPHANOPTS
This variable specifies
.BR deborphan (1)
command options. Built-in defaults are:
.PP
ORPHANOPTS="\-\-libdevel \-\-guess\-all \-\-no-guess\-debug"
.PP
Consult the
.BR deborphan (1)
manual page to check which options are available for
any particular version, before setting this variable.
.SS CLEANOPTS
This variable selects which one of
.BR autoclean
or
.BR clean
to execute as the
.BR apt\-get (8)
cleaning command. Built-in default is:
.PP
CLEANOPTS="clean"
.PP
Consult the
.BR apt\-get (8)
manual page to check which options are available for any
particular version, before setting this variable.
.SS FLAUSCH
Setting this variable enables various extremely pedantic purge options.
.PP
This variable has no default value.
.PP
This feature is totally experimental; usage is strongly discouraged and
should only be attempted by truly experienced Debian administrators. It
can be used to sanitize a Debian system after a distribution upgrade or
to detect packages that don't conform to the Debian Policy. Setting the
variable as a command line environment, only when needed, is considered
a safer approach than adding it to
.BR upgrade\-system.conf
variables.
.PP
.B sudo FLAUSCH=jawohl upgrade\-system
.SH "NOTES"
In the absence of a configuration file,
.BR upgrade\-system (8)
will use the above built\-in default values.
.BR apt\-get (8)
\-\-purge \-\-option APT::Get::Build\-Dep\-Automatic=true
options roughly correspond to
.BR deborphan (1)
\-\-find\-config \-\-libdevel.
Because
.BR upgrade\-system (8)
is an APT front-end, all precautions relating to APT configuration
should be observed. Pay special attention to:
.TP
.IR /etc/apt/preferences
.PP
To prevent untested packages from overwriting stable ones, setting
this combination of APT preferences is recommended:
.PP
.RS
.nf
Package: *
Pin: release a=stable
Pin\-Priority: 990
Package: *
Pin: release a=testing
Pin\-Priority: 500
Package: *
Pin: release a=unstable
Pin\-Priority: 100
Package: *
Pin: release a=experimental
Pin\-Priority: 1
.fi
.RE
.PP
This enforces a priority on packages from Stable, yet still allows ones
from Testing, Unstable or Experimental to get installed via appropriate
.BR apt\-get (8)
options to override the default release.
.SH "BUGS"
Certain combinations of
.BR deborphan (1)
options purge a dangerous quantity of packages,
potentially leaving a system in a severely crippled state.
.SH "AUTHORS"
Copyright \(co 2004-2025 Martin\-\['E]ric Racine <martin\-eric.racine@iki.fi>
.br
Copyright \(co 2004,2012 Christoph Schindler <hop@30hopsmax.at>
.br
Copyright \(co 2003-2004 Martin Zdrahal <martin.zdrahal@konflux.at>
.SH "LICENSE"
SPDX-License-Identifier: GPL-2.0-or-later
.SH "SEE ALSO"
.BR apt\-get (8),
.BR apt_preferences (5),
.BR deborphan (1),
.BR upgrade\-system (8).
|
