- spl23
- Raspberry Pi Engineer & Forum Moderator
Raspberry Pi Engineer & Forum Moderator - Posts: 687
- Joined: Fri Dec 26, 2014 11:02 am
Upgrading a bookworm image to trixie
The latest version of Raspberry Pi OS is now released, based on Debian trixie.
As always with major Debian version upgrades, we do not recommend updating an existing bookworm image, and offer no support for problems encountered when attempting this - our recommended approach will always be to start with a clean trixie image (either from Raspberry Pi Imager or the Software page on the website) and to install whatever programs and data you need from your previous bookworm image.
While we do what we can to make sure that it is in theory possible to upgrade a bookworm image, we can only test clean images; we cannot test every combination of software and configuration that a user might have applied, and any such changes can cause the update to fail in a fashion we could not predict which may leave you with a broken and unrecoverable system.
You should not attempt to upgrade any system on which you are relying, and you should not attempt to upgrade any system without taking a full backup first. We are not responsible if this process does result in a broken image - all we can say is that the upgrade process described here has been tested and found to work on the most recent clean bookworm image. But if you do this, it is at your own risk.
It is probably also worth reading Debian's official guidance on updating from bookworm to trixie, which can be found here : https://www.debian.org/releases/trixie/ ... ng.en.html
With all that said, if you still want to try upgrading to trixie - here is how to do it.
1. Start with a bookworm image running the desktop under labwc, and make sure it is up to date with all recent changes by doing
2. Update the apt configuration for trixie.
In the file /etc/apt/sources.list, change every reference to "bookworm" to "trixie".
Do the same in every file in /etc/apt/sources.list.d/ - on a clean image, this will only involve the file raspi.list, but if you have added any other repositories to this directory, their list files should also be updated.
3. Run an apt update
4. Remove obsolete bookworm code
5. Upgrade bookworm packages to trixie
This line must be entered exactly as above - check the punctuation!
5. Install new trixie packages
On a Pi 5 with a fast Internet connection, the trixie upgrade takes approximately 15-20 minutes to run. While it is running, you will be prompted to ask whether to restart services - answer "yes" to this question. If asked any other questions during the upgrade, "yes" is probably the right answer!
At the end, assuming the process completed without errors, it is worth running a "sync" just to make sure the file system has cleared all its caches, and then reboot. When the desktop comes back, you can confirm that you are now running trixie by opening a terminal and typing "lsb_release -c".
As always with major Debian version upgrades, we do not recommend updating an existing bookworm image, and offer no support for problems encountered when attempting this - our recommended approach will always be to start with a clean trixie image (either from Raspberry Pi Imager or the Software page on the website) and to install whatever programs and data you need from your previous bookworm image.
While we do what we can to make sure that it is in theory possible to upgrade a bookworm image, we can only test clean images; we cannot test every combination of software and configuration that a user might have applied, and any such changes can cause the update to fail in a fashion we could not predict which may leave you with a broken and unrecoverable system.
You should not attempt to upgrade any system on which you are relying, and you should not attempt to upgrade any system without taking a full backup first. We are not responsible if this process does result in a broken image - all we can say is that the upgrade process described here has been tested and found to work on the most recent clean bookworm image. But if you do this, it is at your own risk.
It is probably also worth reading Debian's official guidance on updating from bookworm to trixie, which can be found here : https://www.debian.org/releases/trixie/ ... ng.en.html
With all that said, if you still want to try upgrading to trixie - here is how to do it.
1. Start with a bookworm image running the desktop under labwc, and make sure it is up to date with all recent changes by doing
Code: Select all
sudo apt update
sudo apt full-upgrade
In the file /etc/apt/sources.list, change every reference to "bookworm" to "trixie".
Do the same in every file in /etc/apt/sources.list.d/ - on a clean image, this will only involve the file raspi.list, but if you have added any other repositories to this directory, their list files should also be updated.
3. Run an apt update
Code: Select all
sudo apt update
Code: Select all
sudo apt purge -y raspberrypi-ui-mods
sudo apt autoremove -y
Code: Select all
sudo apt full-upgrade -y -o Dpkg::Options::="--force-confdef" -o Dpkg::Options::="--force-confnew" --purge --auto-remove
5. Install new trixie packages
Code: Select all
sudo apt install -y rpd-wayland-all rpd-x-all
At the end, assuming the process completed without errors, it is worth running a "sync" just to make sure the file system has cleared all its caches, and then reboot. When the desktop comes back, you can confirm that you are now running trixie by opening a terminal and typing "lsb_release -c".
Jump to
- Community
- General discussion
- Announcements
- Other languages
- Deutsch
- Español
- Français
- Italiano
- Nederlands
- 日本語
- Polski
- Português
- Русский
- Türkçe
- User groups and events
- Raspberry Pi Official Magazine
- Using the Raspberry Pi
- Beginners
- Troubleshooting
- Advanced users
- Assistive technology and accessibility
- Education
- Picademy
- Teaching and learning resources
- Staffroom, classroom and projects
- Astro Pi
- Mathematica
- High Altitude Balloon
- Weather station
- Programming
- C/C++
- Java
- Python
- Scratch
- Other programming languages
- Windows 10 for IoT
- Wolfram Language
- Bare metal, Assembly language
- Graphics programming
- OpenGLES
- OpenVG
- OpenMAX
- General programming discussion
- Projects
- Networking and servers
- Automation, sensing and robotics
- Graphics, sound and multimedia
- Other projects
- Media centres
- Gaming
- AIY Projects
- Hardware and peripherals
- Camera board
- Compute Module
- Official Display
- HATs and other add-ons
- Device Tree
- Interfacing (DSI, CSI, I2C, etc.)
- Keyboard computers (400, 500, 500+)
- Raspberry Pi Pico
- General
- SDK
- MicroPython
- Other RP2040 boards
- Zephyr
- Rust
- AI Accelerator
- AI Camera - IMX500
- Hailo
- Software
- Raspberry Pi OS
- Raspberry Pi Connect
- Raspberry Pi Desktop for PC and Mac
- Beta testing
- Other
- Android
- Debian
- FreeBSD
- Gentoo
- Linux Kernel
- NetBSD
- openSUSE
- Plan 9
- Puppy
- Arch
- Pidora / Fedora
- RISCOS
- Ubuntu
- Ye Olde Pi Shoppe
- For sale
- Wanted
- Off topic
- Off topic discussion