.. _debian_13_upgrade_notes:

**********************************
Debian 13 (Trixie) Upgrade Notes
**********************************

Debian was upgraded to Debian 13 (Trixie) in XiVO 2026.XX release.

.. warning:: Upgrade from versions *earlier* than XiVO Maia (2024.05) are not supported.
     You MUST first upgrade to at least XiVO Maia (2024.05) or more before upgrading to XiVO Maia.


.. _debian_13_upgrade_notes_before:

Before the upgrade
==================

.. important:: **Make sure you have sufficient space for the upgrade**.
   You should have more than 2GiB available in the filesystem that holds the ``/var`` and ``/`` directories.

* If using a separate ``/boot`` partition check there is enough space - see `Ensure /boot has enough free space <https://www.debian.org/releases/trixie/release-notes/issues.en.html#ensure-boot-has-enough-free-space>`_
* It is not possible to upgrade from XiVO below Maia (2024.05) version. You first need to upgrade to XiVO Maia.
* Note that the upgrade will take longer than usual because of all the system upgrade.
* You **MUST** deactivate all non-xivo apt sources list:

  * in directory `/etc/apt/sources.list.d/` you should only have the files :file:`xivo-dist.list` and (from Aldebaran) :file:`docker.list` :file:`pgdg.list`.
  * you **MUST** suffix all other files with `.save` to deactivate them.
* You **MUST** check the Debian sources list are correct: the file :file:`/etc/apt/sources.list` must contain the following and only the following::

   deb http://deb.debian.org/debian/ trixie main
   deb-src http://deb.debian.org/debian/ trixie main
 
   deb http://security.debian.org/debian-security trixie-security main
   deb-src http://security.debian.org/debian-security trixie-security main
 
   deb http://deb.debian.org/debian/ trixie-updates main
   deb-src http://deb.debian.org/debian/ trixie-updates main

* You may want to clean your system before upgrading:

  * Remove package that were automatically installed and are not needed anymore::

     apt-get autoremove --purge
  * Purge removed packages. You can see the list of packages in this state by running ``dpkg -l |
    awk '/^rc/ { print $2 }'`` and purge all of them with::

      apt-get purge $(dpkg -l | awk '/^rc/ { print $2 }')
  * Remove :file:`.dpkg-old`, :file:`.dpkg-dist` and :file:`.dpkg-new` files from previous upgrade. You can see a list
    of these files by running::

      find /etc -name '*.dpkg-old' -o -name '*.dpkg-dist' -o -name '*.dpkg-new'


.. _debian_13_upgrade_notes_after:

After the upgrade
=================

* Check if network interface name might change - see `Network interface names may change <https://www.debian.org/releases/trixie/release-notes/issues.en.html#network-interface-names-may-change>`_

.. _debian_13_upgrade_notes_changes:

Changes
=======

Major change with XiVO on Debian 13:

* file `/etc/sysctl.conf` is no longer read. Use files in `/etc/sysctl.d/*.conf` instead - see `/etc/sysctl.conf is no longer honored <https://www.debian.org/releases/trixie/release-notes/issues.en.html#etc-sysctl-conf-is-no-longer-honored>`_
* file stored in `/tmp` are now stored in memory ; **be careful to not store big** files there ! - see `The temporary-files directory /tmp is now stored in a tmpfs <https://www.debian.org/releases/trixie/release-notes/issues.en.html#the-temporary-files-directory-tmp-is-now-stored-in-a-tmpfs>`_
* note that `the directories /tmp and /var/tmp are now regularly cleaned <https://www.debian.org/releases/trixie/release-notes/issues.en.html#the-directories-tmp-and-var-tmp-are-now-regularly-cleaned>`_ (note that it is not activated by default after the upgrade)
* :file:`/etc/timezone` file is deprecated and not present on newer Debian 13 install


External Links
==============

`Official Debian 13 Release Notes <https://https://www.debian.org/releases/trixie/release-notes/>`_