Debian Setup Script Improvements

May 18 2022

This is a heads up for our Debian users! As of today, we have updated our repository setup script and documentation to no longer rely on the recently deprecated apt-key binary.

What does this mean?

The apt-key binary was previously used within the Cloudsmith setup script for Debian systems to install the repository GPG key to the system keyring. This method is no longer recommended and is deprecated from Debian Stretch and Ubuntu 22.04 onwards. Debian encourages user keyrings for repository signing keys, and we have taken note!

What is the impact?

For most users, there should be no material impact. Existing repository installations will continue to function as usual. Users who leverage the generated script will notice that this now installs repository keys via the more secure and recommended approach. We have also tailored this to ensure that our users on legacy systems remain unaffected.

If, however you or your users leverage the config.deb.txt endpoint, please note that this now automatically includes the signed-by directive, expecting the GPG key to be installed to /usr/share/keyrings.

I don't use the setup script. How do I add my repository now?

You can now use the following manual steps to install Debian repositories:

# For Debian Stretch, Ubuntu 16.04 and later
keyring_location=/usr/share/keyrings/<owner>-<repo>-archive-keyring.gpg 

# For Debian Jessie, Ubuntu 15.10 and earlier
keyring_location=/etc/apt/trusted.gpg.d/<owner>-<repo>.gpg curl -1sLf 'https://dl.cloudsmith.io/public/<owner>/<repo>/gpg.<fingerprint>.key' |  gpg --dearmor > curl -1sLf 'https://dl.cloudsmith.io/public/<owner>/<repo>/config.deb.txt?distro=<distro>&codename=<version>' > /etc/apt/sources.list.d/<owner>-<repo>.list 
apt-get update

These steps are also available in the contextual documentation for each of your repositories under the 'Set Me Up' button.

Debian Repository Documentation

Keep up to date with our monthly product bulletin

By submitting this form, you agree to our privacy policy