Provided by: apt_1.6.1_amd64 bug


       apt_auth.conf - Login configuration file for APT sources and proxies


       APT configuration files like sources.list(5) or apt.conf(5) need 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

       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 ftp(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.

       machine hostname[:port][/path]
           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.

       login name
           The username to be used.

       password string
           The password to be used.


       Supplying login information for a user named apt with the password debian for the
       sources.list(5) entry

           deb stretch main

       could be done in the entry directly:

           deb stretch main

       Alternatively an entry like the following in the auth.conf file could be used:

           login apt
           password debian

       Or alternatively within a single line:

           machine login apt password debian

       If you need to be more specific all of these lines will also apply to the example entry:

           machine login apt password debian
           machine login apt password debian
           machine login apt password debian

       On the other hand neither of the following lines apply:

           machine login apt password debian
           machine login apt password debian
           machine login apt password debian
           machine example.orga login apt password debian
           machine 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.conf(5) sources.list(5)


       APT bug page[1]. If you wish to report a bug in APT, please see
       /usr/share/doc/debian/bug-reporting.txt or the reportbug(1) command.


       APT team


        1. APT bug page