1 /* This file is an index of all APT configuration directives. It should
2 NOT actually be used as a real config file, though it is (except for the
3 last line) a completely valid file. Most of the options have sane default
4 values, unless you have specific needs you should NOT include arbitrary
5 items in a custom configuration.
7 In some instances involving filenames it is possible to set the default
8 directory when the path is evaluated. This means you can use relative
9 paths within the sub scope.
11 The configuration directives are specified in a tree with {} designating
12 a subscope relative to the tag before the {}. You can further specify
13 a subscope using scope notation eg,
14 APT::Architecture "i386";
15 This is prefixed with the current scope. Scope notation must be used
16 if an option is specified on the command line with -o.
21 // Options for APT in general
25 Build-Essential "build-essential";
27 NeverAutoRemove { "linux-image.*"; }; // packages that should never
28 // considered for autoRemove
30 // Options for apt-get
34 AllowUnauthenticated "false";
35 AutomaticRemove "false";
36 HideAutoRemove "false";
37 Download-Only "false";
40 Force-Yes "false"; // I would never set this.
43 Show-Upgraded "false";
44 Show-Versions "false";
57 Build-Dep-Automatic "true";
65 RecurseDepends "false";
83 Pre-Invoke {"touch /var/lib/apt/pre-update-stamp"; };
84 Post-Invoke {"touch /var/lib/apt/post-update-stamp"; };
89 TrustCDROM "false"; // consider the CDROM always trusted
94 TrustedKeyring "/etc/apt/trusted.gpg";
97 // Some general options
99 Clean-Installed "true";
100 Immediate-Configure "true"; // DO NOT turn this off, see the man page
101 Force-LoopBreak "false"; // DO NOT turn this on, see the man page
102 Cache-Limit "4194304";
105 // consider Recommends, Suggests as important dependencies that should
106 // be installed by default
107 Install-Recommends "true";
108 Install-Suggests "false";
110 // consider dependencies of packages in this section manual
111 Never-MarkAuto-Sections {"metapackages"; "universe/metapackages"; };
113 // Write progress messages on this fd (for stuff like base-config)
115 // Keep the list of FDs open (normally apt closes all fds when it
120 // Options for the downloading routines
123 Queue-Mode "host"; // host|access
125 Source-Symlinks "true";
127 PDiffs "true"; // try to get the IndexFile diffs
129 // HTTP method configuration
132 Proxy "http://127.0.0.1:3128";
133 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
137 // Cache Control. Note these do not work with Squid 2.0.2
139 Max-Age "86400"; // 1 Day age on index files
140 No-Store "false"; // Prevent the cache from storing archives
141 Dl-Limit "7"; // 7Kb/sec maximum download rate
144 // HTTPS method configuration:
145 // - uses the http proxy config
146 // - uses the http cache-control values
147 // - uses the http Dl-Limit values
151 SslCert "/etc/apt/some.pem";
152 CaPath "/etc/ssl/certs";
158 Proxy "ftp://127.0.0.1/";
159 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
161 /* Required script to perform proxy login. This example should work
165 "USER $(PROXY_USER)";
166 "PASS $(PROXY_PASS)";
167 "USER $(SITE_USER)@$(SITE):$(SITE_PORT)";
173 /* Passive mode control, proxy, non-proxy and per-host. Pasv mode
174 is preferred if possible */
176 Proxy::Passive "true";
177 Passive::http.us.debian.org "true"; // Specific per-host setting
184 // You need the trailing slash!
194 Options {"--ignore-time-conflict";} // not very useful on a normal system
201 // Location of the state dir
206 userstatus "status.user";
207 status "/var/lib/dpkg/status";
208 cdroms "cdroms.list";
211 // Location of the cache dir
212 Cache "var/cache/apt/" {
213 Archives "archives/";
214 srcpkgcache "srcpkgcache.bin";
215 pkgcache "pkgcache.bin";
220 SourceList "sources.list";
222 Preferences "preferences";
226 // Locations of binaries
228 methods "/usr/lib/apt/methods/";
231 dpkg "/usr/bin/dpkg";
232 dpkg-source "/usr/bin/dpkg-source";
233 dpkg-buildpackage "/usr/bin/dpkg-buildpackage";
234 apt-get "/usr/bin/apt-get";
235 apt-cache "/usr/bin/apt-cache";
238 // Location of the logfile
244 // Things that effect the APT dselect method
247 Clean "auto"; // always|auto|prompt|never
250 PromptAfterUpdate "no";
256 // Probably don't want to use force-downgrade..
257 Options {"--force-overwrite";"--force-downgrade";}
259 // Auto re-mounting of a readonly /usr
260 Pre-Invoke {"mount -o remount,rw /usr";};
261 Post-Invoke {"mount -o remount,ro /usr";};
263 // Prevents daemons from getting cwd as something mountable (default)
266 // Build options for apt-get source --compile
267 Build-Options "-b -uc";
269 // Pre-configure all packages before they are installed using debconf.
270 Pre-Install-Pkgs {"dpkg-preconfigure --apt --priority=low --frontend=dialog";};
272 // Flush the contents of stdin before forking dpkg.
275 // Control the size of the command line passed to dpkg.
279 // controls if apt will apport on the first dpkg error or if it
280 // tries to install as many packages as possible
284 /* Options you can set to see some debugging text They correspond to names
285 of classes in the source code */
288 pkgProblemResolver "false";
289 pkgDepCache::AutoInstall "false"; // what packages apt install to satify dependencies
291 pkgAcquire::Worker "false";
292 pkgAcquire::Auth "false";
294 pkgDPkgProgressReporting "false";
295 pkgOrderList "false";
296 pkgAutoRemove "false"; // show information about automatic removes
298 pkgInitialize "false"; // This one will dump the configuration space
300 Acquire::Ftp "false"; // Show ftp command traffic
301 Acquire::Http "false"; // Show http command traffic
302 Acquire::Https "false"; // Show https debug
303 Acquire::gpgv "false"; // Show the gpgv traffic
304 aptcdrom "false"; // Show found package files
309 /* Whatever you do, do not use this configuration file!! Take out ONLY
310 the portions you need! */
311 This Is Not A Valid Config File