Trixie OS

katshann-raspberry · lurch · JeuneseRPi · mudge · commit 4a664715b049 · 2025-10-02T08:06:48.000+01:00
Co-authored-by: Andrew Scheller &lt;andrew.scheller@raspberrypi.com&gt;
Co-authored-by: Jeunese &lt;jeunese.payne@raspberrypi.com&gt;
diff --git a/documentation/asciidoc/computers/config_txt/what_is_config_txt.adoc b/documentation/asciidoc/computers/config_txt/what_is_config_txt.adoc
@@ -14,6 +14,8 @@ Changes to `config.txt` only take effect after a reboot. You can view the curren
 
 NOTE: Not all config settings can be retrieved using `vcgencmd`.
 
+Some legacy `config.txt` options are no longer officially supported. These are listed in xref:../computers/legacy_config_txt.adoc[Legacy config.txt options] and aren't included in this article.
+
 === File format
 
 The `config.txt` file is read by the early-stage boot firmware, so it uses a very simple file format: **a single `property=value` statement on each line, where `value` is either an integer or a string**. Comments may be added, or existing config values may be commented out and disabled, by starting a line with the `#` character.
diff --git a/documentation/asciidoc/computers/os/rpi-os-introduction.adoc b/documentation/asciidoc/computers/os/rpi-os-introduction.adoc
@@ -4,6 +4,17 @@ Raspberry Pi OS is a free, Debian-based operating system optimised for the Raspb
 
 Because Raspberry Pi OS is derived from Debian, it follows a staggered version of the https://wiki.debian.org/DebianReleases[Debian release cycle]. Releases happen roughly every 2 years.
 
-The latest version of Raspberry Pi OS is based on https://www.raspberrypi.com/news/bookworm-the-new-version-of-raspberry-pi-os/[Debian Bookworm]. The previous version was based on https://www.raspberrypi.com/news/raspberry-pi-os-debian-bullseye/[Debian Bullseye].
+The latest version of Raspberry Pi OS is based on https://www.raspberrypi.com/news/trixie-the-new-version-of-raspberry-pi-os/[Debian Trixie]. The previous version was based on https://www.raspberrypi.com/news/bookworm-the-new-version-of-raspberry-pi-os/[Debian Bookworm].
 
-You can find images of Raspberry Pi OS at https://www.raspberrypi.com/software/operating-systems/[raspberrypi.com/software/operating-systems/]
+== Get Raspberry Pi OS
+
+Raspberry Pi OS is available through the xref:../computers/getting-started.adoc#raspberry-pi-imager[Raspberry Pi Imager].
+You can also find images of Raspberry Pi OS at https://www.raspberrypi.com/software/operating-systems/[raspberrypi.com/software/operating-systems/].
+
+We provide 64- and 32-bit versions of the OS in the following editions:
+
+* **Raspberry Pi OS with desktop.** This is the default version of Raspberry Pi OS shown in Raspberry Pi Imager. It includes applications such as the Chromium web browser, Firefox web browser, VLC media player, and the Thonny Python environment.
+* **Raspberry Pi OS with desktop and recommended software.** This is listed as "Raspberry Pi OS Full" in Raspberry Pi Imager. It also includes the LibreOffice suite, KiCad, a programming environment for Scratch, and many other applications.
+* **Raspberry Pi OS Lite.** This version doesn't include a graphical desktop experience. Use it for headless servers and similar use cases. We recommend this version for your Raspberry Pi 1, 2, and Zero computers.
+
+If you're already running a previous version of Raspberry Pi OS and want to instead use the latest major version, we recommend that you don't perform an in-place upgrade. Instead, start again with a new image. For more information, see <<upgrade-your-operating-system-to-a-new-major-version>>.
diff --git a/documentation/asciidoc/computers/os/updating.adoc b/documentation/asciidoc/computers/os/updating.adoc
@@ -175,14 +175,62 @@ $ sudo apt update
 $ sudo apt install --reinstall raspi-firmware
 ----
 
-[NOTE]
-====
-If you still run Raspberry Pi OS Bullseye, you must instead reinstall `raspberrypi-kernel` using the following command:
+=== Convert Raspberry Pi OS Lite into Raspberry Pi OS Desktop
 
+You can add the packages that turn the Lite version into the Desktop version by using `apt`.
+
+. Install your preferred desktop windowing system.
+* To install Wayland (recommended), run:
++
+[source,console]
+----
+$ sudo apt install rpd-wayland-core
+----
+* To install X, run:
++
+[source,console]
+----
+$ sudo apt install rpd-x-core
+----
+. Install the Raspberry Pi theme and Control Centre.
++
+[source,console]
+----
+$ sudo apt install rpd-theme
+$ sudo apt install rpd-preferences
+----
+. Add the applications.
++
+[source,console]
+----
+$ sudo apt install rpd-applications
+$ sudo apt install rpd-utilities
+$ sudo apt install rpd-developer
+$ sudo apt install rpd-graphics
+----
+. Add the extra features for your chosen windowing system, such as screenshot and remote desktop capabilities.
+* For Wayland, run:
++
+[source,console]
+----
+$ sudo apt install rpd-wayland-extras
+----
+* For X, run:
++
+[source,console]
+----
+$ sudo apt install rpd-x-extras
+----
+. Restart your Raspberry Pi to enter the desktop environment.
++
 [source,console]
 ----
-$ sudo apt install --reinstall libraspberrypi0 libraspberrypi-{bin,dev,doc} raspberrypi-{kernel,bootloader}
+$ sudo reboot
 ----
 
-Reboot your Raspberry Pi with `sudo reboot` to put these changes into effect.
-====
+You now have all the packages that comprise Raspberry Pi OS Desktop. If you want to return to the Lite version of Raspberry Pi OS, you can remove these packages.
+
+You can also install the recommended applications included in Raspberry Pi OS Full by going to your Raspberry Pi main menu and selecting **Preferences > Recommended Software**.
+
+
+
diff --git a/documentation/asciidoc/computers/software-sources.adoc b/documentation/asciidoc/computers/software-sources.adoc
@@ -158,7 +158,7 @@ A tool to mass provision Raspberry Pi devices (Raspberry Pi 5, Compute Module 4,
 
 === Feedback
 
-http://github.com/raspberrypi/bookworm-feedback::
+http://github.com/raspberrypi/trixie-feedback::
 A repo specifically reserved for bug-reporting for the current Raspberry Pi OS release.
 
 === Raspberry Pi Pico
diff --git a/documentation/asciidoc/services/bookshelf.adoc b/documentation/asciidoc/services/bookshelf.adoc
@@ -0,0 +1,3 @@
+include::bookshelf/intro.adoc[]
+
+include::bookshelf/subscription.adoc[]
diff --git a/documentation/asciidoc/services/bookshelf/images/bookshelf-with-padlock.png b/documentation/asciidoc/services/bookshelf/images/bookshelf-with-padlock.png
diff --git a/documentation/asciidoc/services/bookshelf/intro.adoc b/documentation/asciidoc/services/bookshelf/intro.adoc
@@ -0,0 +1,11 @@
+[[bookshelf]]
+== Introduction
+
+The Bookshelf application in Raspberry Pi OS provides access to books and magazines published by Raspberry Pi Press. Since Raspberry Pi OS Trixie, this also includes contributor-only titles.
+
+* Free titles are indicated by the cloud icon and can be downloaded by anyone.
+* Contributor-only titles are indicated by the padlock symbol unless you're signed in with a xref:../services/id.adoc[Raspberry Pi ID] that's associated with a contribution or a subscription to the print magazine. Some contributor-only titles later become available to all.
+
+image::images/bookshelf-with-padlock.png[width="80%"]
+
+Bookshelf is included in the Raspberry Pi OS Desktop and Raspberry Pi OS Full images.
diff --git a/documentation/asciidoc/services/bookshelf/subscription.adoc b/documentation/asciidoc/services/bookshelf/subscription.adoc
@@ -0,0 +1,24 @@
+[[contribute]]
+== Become a contributor (Raspberry Pi OS Trixie and later)
+
+Contributor-only titles are available to users who are signed in to Bookshelf with a xref:../services/id.adoc[Raspberry Pi ID] that's associated with one of the following things:
+
+* An email address that has a https://raspberrypipress.imbmsubscriptions.com/[subscription to our print magazine]
+* A https://magazine.raspberrypi.com/bookshelf/link[monthly contribution]
+
+To set up a monthly contribution:
+
+. In Bookshelf, select **Contribute...** in the bottom left to open the contributor page on the Raspberry Pi website.
+. If you don't have a Raspberry Pi ID already, you can create one now. If you have an existing Raspberry Pi ID, sign in with your username and password.
+. Sign up for a monthly contribution.
+. Select **Sign in to Bookshelf** to open Bookshelf and store your ID that identifies you as a contributor.
+
+The **Contribute...** button is no longer shown and all titles can now be downloaded.
+
+You can sign in with your Raspberry Pi ID and access available titles from any number of devices. If you move to a new Raspberry Pi or flash your SD with a different version of Raspberry Pi OS, sign in and download your favourite titles again.
+
+== Download titles
+
+Double-click on any of the available titles to download them as a PDF and open them in the default PDF reader.
+
+If you stop your monthly contribution, you keep any titles that you've already downloaded. These PDF files are stored in the **Bookshelf** folder of your home directory and remain accessible through Bookshelf.
diff --git a/documentation/images/Bookshelf-SMALL.png b/documentation/images/Bookshelf-SMALL.png
diff --git a/documentation/images/full-sized/Bookshelf.png b/documentation/images/full-sized/Bookshelf.png
diff --git a/documentation/index.json b/documentation/index.json
@@ -29,12 +29,6 @@
                     "image": "full-sized/The-config-txt-file.png",
                     "subpath": "config_txt.adoc"
                 },
-                {
-                    "title": "Legacy `config.txt` options",
-                    "description": "Options which may be useful for OSes other than Raspberry Pi OS",
-                    "image": "full-sized/Legacy-config-txt.png",
-                    "subpath": "legacy_config_txt.adoc"
-                },
                 {
                     "title": "The Linux kernel",
                     "description": "How to configure and build a custom kernel for your Raspberry Pi",
@@ -88,6 +82,12 @@
                     "description": "Open source software by Raspberry Pi",
                     "image": "full-sized/software-sources.png",
                     "subpath": "software-sources.adoc"
+                },
+                {
+                    "title": "Legacy `config.txt` options",
+                    "description": "Options which might be useful for OSes other than Raspberry Pi OS",
+                    "image": "full-sized/Legacy-config-txt.png",
+                    "subpath": "legacy_config_txt.adoc"
                 }
             ]
         },
@@ -263,6 +263,12 @@
                     "description": "Connect to your Raspberry Pi from your browser",
                     "image": "full-sized/Connect-BIG.png",
                     "subpath": "connect.adoc"
+                },
+                {
+                    "title": "Bookshelf",
+                    "description": "Read titles published by Raspberry Pi Press",
+                    "image": "full-sized/Bookshelf.png",
+                    "subpath": "bookshelf.adoc"
                 }
             ]
         },

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+include::bookshelf/intro.adoc[]`
	`2`	`+`
	`3`	`+include::bookshelf/subscription.adoc[]`