debhelper-compat-upgrade-checklist - Linux


debhelper-compat-upgrade-checklist helps in migrating Debian packages to a newer Debian release and notifies about possible source and build issues.


debhelper-compat-upgrade-checklist [options] <suite>


  • -h, –help: Display help information
  • -V, –version: Display version information
  • –no-popcon: Do not report results to Popularity Contest
  • –user=: Run as the specified user
  • –before: Override the debhelper compat checker version
  • –after: Override the latest debhelper compat checker version


  • Check for source compatibility issues when migrating to Debian 12:
debhelper-compat-upgrade-checklist bookworm
  • Check for both source and build compatibility issues:
DEB_BUILD_OPTIONS=nocheck debhelper-compat-upgrade-checklist bookworm

Common Issues

  • Ensure that you have the latest version of debhelper installed
  • Consult the Debian Policy Manual for more information on source compatibility
  • If you encounter any compatibility issues, consider reaching out to the Debian mentors on IRC or the mailing list


  • Use debhelper-compat-upgrade-checklist as a pre-build step to identify potential compatibility issues before running dpkg-buildpackage
  • Integrate the command into a build pipeline to automate compatibility checks

Related Commands

  • debhelper-build
  • dpkg-source
  • dpkg-buildpackage