apt_auth.conf - Login configuration file for APT sources and proxies
APT configuration files like sources.list
(5) or apt.conf
to be accessible for everyone using apt tools on the system to have access to
all package-related information like the available packages in a repository.
Login information needed to connect to a proxy or to download data from a
repository on the other hand shouldn't always be accessible by everyone and
can hence not be placed in a file with world-readable file permissions.
The APT auth.conf file /etc/apt/auth.conf can be used to store login information
in a netrc-like format with restrictive file permissions.
The format defined here is similar to the format of the ~/.netrc file used by
(1) and similar programs interacting with servers. It is a simple
token-based format with the following tokens being recognized; Unknown tokens
will be ignored. Tokens may be separated by spaces, tabs or newlines.
Entries are looked up by searching for the
machine token matching the hostname of the URI apt needs login
information for. Extending the netrc-format a portnumber can be specified. If
no port is given the token matches for all ports. Similar the path is optional
and only needed and useful if multiple repositories with different login
information reside on the same server. A machine token with a path matches if
the path in the URI starts with the path given in the token. Once a match is
made, the subsequent tokens are processed, stopping when the end of file is
reached or another machine token is encountered.
The username to be used.
The password to be used.
Supplying login information for a user named apt with the password debian for
deb http://example.org/debian stretch main
could be done in the entry directly:
deb http://apt:email@example.com/debian stretch main
Alternatively an entry like the following in the auth.conf file could be used:
Or alternatively within a single line:
machine example.org login apt password debian
If you need to be more specific all of these lines will also apply to the
machine example.org/deb login apt password debian
machine example.org/debian login apt password debian
machine example.org/debian/ login apt password debian
On the other hand neither of the following lines apply:
machine example.org:80 login apt password debian
machine example.org/deb/ login apt password debian
machine example.org/ubuntu login apt password debian
machine example.orga login apt password debian
machine example.net login apt password debian
Basic support for this feature is present since version 0.7.25, but was
undocumented for years. The documentation was added in version 1.5 changing
also the implementation slightly. For maximum backward compatibility you
should avoid multiple machine tokens with the same hostname, but if you need
multiple they should all have a path specified in the machine token.
Login information for APT sources and proxies
in a netrc-like format. Configuration Item: Dir::Etc::netrc.
APT bug page
. If you wish to report a bug in APT, please see
/usr/share/doc/debian/bug-reporting.txt or the reportbug
- APT bug page