NAME¶

/etc/extrepo/config.yaml - config file for extrepo

SYNOPSIS¶

    url: https://extrepo-team.pages.debian.net/extrepo-data
    dist: debian
    version: bookworm
    enabled_policies:
    - main
    tor: auto

DESCRIPTION¶

The file /etc/extrepo/config.yaml allows to configure options for extrepo. It is a simple YAML file that is parsed with YAML::XS (i.e., libyaml); so any formatting options that are supported by that implementation will be supported by the extrepo config file.

OPTIONS¶

The following options are supported:

url

The URL where extrepo will download metadata from. This should usually be left to its default of <https://extrepo-team.pages.debian.net/extrepo-data>. However, if the system is behind a firewall, it may be necessary to use a local mirror or reverse proxy for the extrepo-data repository. In that case, fill out the URL for that mirror or reverse proxy here.

dist

It is foreseen that perhaps some downstream distributions of Debian may want to add support for their own extrepo configuration. In that case, they would use a different distribution name for this configuration item.

Currently, however, the only supported value for this configuration option is "debian".

version

The codename of the distribution that you are using. Supported values here include all active code names for Debian, although the extrepo program itself is only supported from Debian buster onwards.

enabled_policies

The package licensing policies that are enabled for this system. By default, only the "main" policy is enabled. This policy requires that all packages in the distribution adhere to the Debian Free Software Guidelines, or DFSG, and that software in such a repository may only depend on other repositories that have "main" as a policy, as in Debian's "main" repository.

Additional valid options for this key are "contrib", which requires that licenses for software in the repository also adhere to the DFSG (but makes no such requirements on any dependencies), and "non-free", which has no restrictions whatsoever.

While every effort is made that software repositories are labelled correctly, the maintainers of the extrepo-data repository make no guarantee as to its correctness.

tor

The default tor mode to be used for installed repositories. If not specified, defaults to "off". Can be overridden with the "--tor" option to the extrepo command; see the documentation of that option in extrepo(1) for a list of the valid options here.

SEE ALSO¶

extrepo(1)

AUTHOR¶

Wouter Verhelst