The debusine client configuration file

This is the reference documentation for the configuration file of the debusine client command, which is read from ~/.config/debusine/client/config.ini.

The command follows the ini file syntax as understood by Python’s configparser.

This is an example configuration file:

[General]
default-server = debusine.debian.net

[server:debusine.debian.net]
api-url = https://debusine.debian.net/api
scope = debian
token = 12345678901234567890

[General] section

The General section contains global settings for the client command.

The only global setting defined so far is default-server, which is used to select which of the following server: sections (see below) is used when to server is explicitly specified on the command line.

[server:*] section

The configuration defines a server section for each server the Debusine command can access. The section name starts with server: followed by the server name.

Each server can be configured with these keys:

  • api-url (mandatory): toplevel URL of the server API. In most cases it’s the server /api URL.

  • scope (mandatory): scope to access with this server entry.

  • token (mandatory): authentication token (see Create an API token).