Apt-key - Deprecated APT key management utility

First of all, I’m not sure whether I’ve chosen the right category since the main page’s description talks about “Add your findings …” but when I create a new topic I get this information:
“The Tutorials and Guides section is meant for sharing guides / tutorials / howtos you made or found.
If you want to ask a question this is not the place. Please look for a more fitting category.”
Maybe it would have been better to file a issue a github, but I wasn’t able to figure out the right repository.

The docs about icinga, icingaweb, icingadb etc. still refer to use ap-key which is deprecated and will not longer be available after Debian 11 and Ubuntu 22.04. Instead of adding the icinga key with

wget -O - https://packages.icinga.com/icinga.key | apt-key add -

to the main keyring, additional keys should stored separately in dedicated files e.g. in /etc/apt/keyrings (which may not exist by default and needs to be created first) and additional sources.list entries should refer to them directly. To download the key this command could be used:

curl https://packages.icinga.com/icinga.key | gpg --dearmor --yes -o /etc/apt/keyrings/icinga.gpg

To create a corresponding sources.list entry

DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \
 echo "deb https://packages.icinga.com/debian icinga-${DIST} main" > \

needs to be replaced with

DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \
 echo "deb [signed-by=/etc/apt/keyrings/icinga.gpg] \
 https://packages.icinga.com/debian icinga-${DIST} main" > \

Details can be found here.

1 Like

Couldn’t this be a PR in icinga2/02-installation.md at master · Icinga/icinga2 · GitHub ? ^^

Yes, that looks good. However, there are still many installation instructions on icinga.com which needs to be updated.

I think, the docs on icinga.com are coming from the docs in the repo. Am I right @theFeu ?

Yes, this is correct!
They are rendered from the markdown docs in the repository that you linked in a nightly job.
So if there are new changes in the repo, they will be in the icinga.com docs the next day :slight_smile:

1 Like