Release Notes for Debian 12 (bookworm), 64-bit PC

The Debian Documentation Project

This document is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

The license text can also be found at and /usr/share/common-licenses/GPL-2 on Debian systems.

Table of Contents

1. Introduction
1.1. Reporting bugs on this document
1.2. Contributing upgrade reports
1.3. Sources for this document
2. What's new in Debian 12
2.1. Supported architectures
2.2. Archive areas
2.3. What's new in the distribution?
2.3.1. Desktops and well known packages
2.3.2. More translated man pages
2.3.3. News from Debian Med Blend
2.3.4. News from Debian Astro Blend
3. Installation System
3.1. What's new in the installation system?
3.2. Cloud installations
3.3. Container and Virtual Machine images
4. Upgrades from Debian 11 (bullseye)
4.1. Preparing for the upgrade
4.1.1. Back up any data or configuration information
4.1.2. Inform users in advance
4.1.3. Prepare for downtime on services
4.1.4. Prepare for recovery
4.1.5. Prepare a safe environment for the upgrade
4.2. Start from pure Debian
4.2.1. Upgrade to Debian 11 (bullseye)
4.2.2. Upgrade to latest point release
4.2.3. Debian Backports
4.2.4. Prepare the package database
4.2.5. Remove obsolete packages
4.2.6. Remove non-Debian packages
4.2.7. Clean up leftover configuration files
4.2.8. The non-free and non-free-firmware components
4.2.9. The proposed-updates section
4.2.10. Unofficial sources
4.2.11. Disabling APT pinning
4.2.12. Check gpgv is installed
4.2.13. Check package status
4.3. Preparing APT source-list files
4.3.1. Adding APT Internet sources
4.3.2. Adding APT sources for a local mirror
4.3.3. Adding APT sources from optical media
4.4. Upgrading packages
4.4.1. Recording the session
4.4.2. Updating the package list
4.4.3. Make sure you have sufficient space for the upgrade
4.4.4. Stop monitoring systems
4.4.5. Minimal system upgrade
4.4.6. Upgrading the system
4.5. Possible issues during upgrade
4.5.1. Full-upgrade fails with Could not perform immediate configuration
4.5.2. Expected removals
4.5.3. Conflicts or Pre-Depends loops
4.5.4. File conflicts
4.5.5. Configuration changes
4.5.6. Change of session to console
4.6. Upgrading your kernel and related packages
4.6.1. Installing a kernel metapackage
4.7. Preparing for the next release
4.7.1. Purging removed packages
4.8. Obsolete packages
4.8.1. Transitional dummy packages
5. Issues to be aware of for bookworm
5.1. Upgrade specific items for bookworm
5.1.1. Non-free firmware moved to its own component in the archive
5.1.2. Changes to packages that set the system clock
5.1.3. Puppet configuration management system upgraded to 7
5.1.4. youtube-dl replaced with yt-dlp
5.1.5. Fcitx versions no longer co-installable
5.1.6. MariaDB package names no longer include version numbers
5.1.7. Changes to system logging
5.1.8. rsyslog changes affecting log analyzers such as logcheck
5.1.9. rsyslog creates fewer log files
5.1.10. slapd upgrade may require manual intervention
5.1.11. GRUB no longer runs os-prober by default
5.1.12. GNOME has reduced accessibility support for screen readers
5.1.13. Changes to polkit configuration
5.1.14. A merged-/usr is now required
5.1.15. Unsupported upgrades from buster fail on libcrypt1
5.1.16. Things to do post upgrade before rebooting
5.2. Items not limited to the upgrade process
5.2.1. Limitations in security support
5.2.2. Python Interpreters marked externally-managed
5.2.3. Limited hardware-accelerated video encoding/decoding support in VLC
5.2.4. systemd-resolved has been split into a separate package
5.2.5. systemd-boot has been split into a separate package
5.2.6. systemd-journal-remote no longer uses GnuTLS
5.2.7. Extensive changes in adduser for bookworm
5.2.8. Predictable naming for Xen network interfaces
5.2.9. Change in dash handling of circumflex
5.2.10. netcat-openbsd supports abstract sockets
5.3. Obsolescence and deprecation
5.3.1. Noteworthy obsolete packages
5.3.2. Deprecated components for bookworm
5.4. Known severe bugs
6. More information on Debian
6.1. Further reading
6.2. Getting help
6.2.1. Mailing lists
6.2.2. Internet Relay Chat
6.3. Reporting bugs
6.4. Contributing to Debian
A. Managing your bullseye system before the upgrade
A.1. Upgrading your bullseye system
A.2. Checking your APT source-list files
A.3. Performing the upgrade to latest bullseye release
A.4. Removing obsolete configuration files
B. Contributors to the Release Notes