[GUIDE] Debian 12 on the Framework Laptop (All Framework Laptop 13 models)

[junaruga]

This thread manages Debian 12 (Bookworm). This thread is a wiki. Anyone who has the permission to edit the wiki can edit this thread’s first comment.

Known issues or reports

Intel

• [SOLVED] Debian 12 / F13 11th gen sound not working
• [RESOLVED] Gen12, Debian 12: Powermanagement (can't find the guide)
• [GUIDE] Debian 12 (Bookworm) Works Great on 13th Gen (Intel) Framework 13
• [SOLVED] Debian 12 display lockups
• Debian 12 not recognizing fingerprint reader

AMD

• [RESOLVED] AMD 7640u Debian 12 - External Monitor no longer working
• [RESPONDED] Brief report: Debian 12 bookworm working on Framework 13 AMD Ryzen 7040 Series
• [RESOLVED] FW13 Ryzen7640 on Debian with 3.03 Bios: Cannot suspend
• [RESOLVED] 13" Ryzen 5 + Debian 12 fails to wake from sleep

Other topics

• [RESPONDED] Debian 12 Support

How to join and report a bug in Debian

• Debian official top page: https://www.debian.org/
• InstallingDebianOn Framework - Debian Wiki
• Debian -- How to join Debian
• Debian bug tracking system
• How to report a bug in the Debian project: Debian -- Debian BTS - reporting bugs

See also

• Debian on the Framework Laptop - The Debian top-level thread.
• [GUIDE] Debian unstable (sid) on the Framework Intel Laptop
• Someone may want to create “Debian unstable (sid) on the Framework AMD Laptop”.
• [TRACKING] Debian testing on the Framework Laptop
• Debian 11 on the Framework Laptop
• Debian based Linux on the Framework Laptop

[Matt_Hartley]

@junaruga deleted our comments to bring the two above closer together.

[junaruga]

@Matt_Hartley All right. Thank you for that. I updated this thread’s first comment.

[P_Ale]

Hello,
just a little feedback from Framework 13 AMD Batch 5 with Debian 12 and backport kernel 6.5.3-1~bpo12+1

Almost everything works out the box except some bugs (could be usefull to list it / I spend a lot of time to search all these informations) :

• Impossible to resume from suspend (black screen while power led is full on) : download last amdgpu firmware from kernel/git/firmware/linux-firmware.git - Repository of firmware blobs for use with the Linux kernel and extract in /usr/lib/firmware/ (see [RESOLVED] FW13 Ryzen7640 on Debian with 3.03 Bios: Cannot suspend ) . I didn’t try firmware-amd-graphics from sid.

• White flashing glitchs after resolution change or sometimes after wake from suspend, resolved by adding kernel parameter : amdgpu.sg_display=0 (see [RESPONDED] Screen flashing partially white on Framework 13 AMD, Ubuntu 22.04 )

• High battery usage during sleep (s2idle) : added kernel parameter rtc_cmos.use_acpi_alarm=1 (see [RESPONDED] AMD loses battery overnight - #2 by Mario_Limonciello and https://gitlab.freedesktop.org/drm/amd/-/blob/master/scripts/amd_s2idle.py?ref_type=heads )
  I’ve to test if USB A module is also in cause

You may also precise somethings specific to AMD (there is a lot of confusion in the threads no precising if what is proposed is intended for intel of AMD) for example :

• Do not use : nvme.noacpi=1 (see [TRACKING] Cannot resume from suspend on AMD - #14)

• There is no deep suspend ; only s2idle available on AMD (see [RESPONDED] AMD 7040 Sleep States ) :
  cat /sys/power/mem_sleep = [s2idle] (so not usefull to tweak with mem_sleep_default=deep )

• FOSS drivers (amdgpu / mesa) ships an old version of openCL 1.1 (from clinfo).
  To install AMD driver for openCL ; see here : Radeon™ Software for Linux® Installation — amdgpu graphics and compute stack unknown-build documentation /// Index of /amdgpu-install/latest/ .
  I couldn’t compile driver for upstream kernel (driver is for ubuntu LTS 22.04) / dkms build fails. So not possible to install the full set of AMD drivers from here.
  But I managed to install only opencl libraries (works at least for darktable) :

  • Download ubuntu 22.04 DEB
  • apt install ./amdgpu-install-VERSION.deb
  • amdgpu-install --usecase=opencl --no-dkms --no-32

And, could you precise (not framework related, more linux) that is not possible with newer kernels, to have secure boot AND hibernation, due to kernel lockdown (or need to patch the kernel) ?

Thank you very much !

[Matt_Hartley]

@P_Ale

just a little feedback from Framework 13 AMD Batch 5 with Debian 12 and backport kernel 6.5.3-1~bpo12+1

Almost everything works out the box except some bugs (could be usefull to list it / I spend a lot of time to search all these informations) :

Appreciate the contribution.

[Daniele]

Hello, debian trixie/sid installed on a Framework 13 AMD Batch 6.

Using the kernel from the distro package linux-image-6.5.0-4-amd64 (which is kernel 6.5.10) and the amdgpu module from kernel-firmware / Linux Firmware · GitLab I did not experience the white-glitching bug for a few days.

Until today,when I turned to the KDE settings characters settings pane, where the fonts and subpixel hinting can be changed. From there I can reliably reproduce the glitching whenever I change any of the settings. I thought it was worth mentioning since it’s very easy to reproduce.

Edit: setting amdgpu.sg_display=0 fixes it for me.

[James_Meagher]

Does anyone know if Debian works with the 11th Gen Framework Laptop? Or should I install Linux Mint, which has been verified to work with Framework Laptop?

[Wade_Richards]

Yep. I ran Debian on my Gen 11, until I installed Windows on it and gave it to my wife. Now I run Debian on my Gen 12 Framework.
It’s not perfect out of the box. I needed to upgrade the kernel (probably not needed anymore since Bookworm) and make some tweaks to get the fingerprint reader to work.
Lots of discussion in [GUIDE] Debian 12 on the Framework Laptop (All Framework Laptop 13 models)

[Escar]

What about the framework 16? Is Debian 12 stable working properly on the FW16?

[Jonathan_Apostoles]

You’ll also want to grab the latest Mediatek firmware (especially if using backports kernels):

kernel-firmware/linux-firmware/-/blob/main/mediatek/BT_RAM_CODE_MT7922_1_1_hdr.bin?ref_type=heads

[juancnuno]

That is provided by the firmware-misc-nonfree package

juancnuno@usscerritos:~$ apt-file search BT_RAM_CODE_MT7922_1_1_hdr.bin
firmware-misc-nonfree: /usr/lib/firmware/mediatek/BT_RAM_CODE_MT7922_1_1_hdr.bin

[Jonathan_Apostoles]

@juancnuno

That is provided by the firmware-misc-nonfree package

That’s correct, but the Bookworm package is providing firmware from early 2023 (20230210), while the linked version is from 4/2024. The bundled version would not allow me to connect to WiFi when running a newer kernel (e.g. 6.6.13 from backports) with Framework’s MT7922 adapter.

Note: I’m on FW13 AMD