|Ambient light sensor||Yes|
This article covers the installation and configuration of Arch Linux on a Framework Laptop.
For a general overview of laptop-related articles and recommendations, see Laptop.
Framework is intended to be a configurable and upgradeable laptop. The lists below is not intended to be an exhaustive list of all the hardware sold with the framework, but rather a list of tested modules that are specially made for the Framework laptop.
|Device Name||PCI ID||Bluetooth USB ID||Working?||Bluetooth?||Notes|
|AX201 vPro||Untested||Untested||Professional Edition|
|AX201 w/o vPro||
||Yes||Yes||DIY Edition (Optional)|
|AX210 w/o vPro||
||Yes||Yes||DIY Edition (Optional)|
|Device Name||PCI ID||Working?|
|Card Name||PCI/USB ID||Working?||Notes|
The Framework laptop includes a 3.5mm combination headphone/headset jack (TRRS). By default, when a device is plugged into the jack, it will be recognized only as headphones. To allow recognition of a headset (with microphone), add the following:
options snd-hda-intel model=dell-headset-multi
acpi_osi options seems to cause CPU stalls on the laptop. This table is just a list of tested values.
||No||Probably the preferred option.|
systemd sets up the reboot watchdog and generates an error when the laptop reboots:
[...] watchdog did not stop
You can disable the shutdown watchdog:
It is currently unknown if self-enrolling secure boot keys work will brick the Framework laptops or not. As a general recommendation, one can set up withAUR or add a password to the BIOS setup menu, enable Secure Boot and manually allow the bootloader to be loaded after upgrades.
The inefficient s2idle (Suspend-To-Idle) suspend variant is pre-selected as default. This state is a generic, pure software, system sleep state. You can select the much more efficient deep (Suspend-To-RAM) variant, which offers significant power savings as everything in the system is put into a low-power state, except for memory, which is placed into the self-refresh mode to retain its contents. Note that the deep variant results in longer resume times.
$ cat /sys/power/mem_sleep [s2idle] deep # echo deep | tee /sys/power/mem_sleep $ cat /sys/power/mem_sleep s2idle [deep]
To make this permanent, add
mem_sleep_default=deep to your kernel parameters.
There are reports of the touchpad exhibiting issues (e.g. pointer does not move, two-finger scroll does not work, etc.) after waking from sleep. Disabling PS/2 mouse emulation under Advanced in the BIOS seems to resolve the issues.
||Yes||Yes||Toggles Fn lock|
||Yes||Yes||Controls the keyboard backlight|
- The key is visible to
xevand similar tools.
- The physical key has a symbol on it, which describes its function.
Stuttering and periodic freeze
There are reports of stuttering and periodic freezes on the laptop when using GNOME and Wayland. Disabling Panel Self-Refresh has been reported to work, although this may no longer be needed on kernel 5.14. PSR is helpful for battery life, so it should be left on if there are no issues.
options i915 enable_psr=0
See also Intel graphics#Screen flickering.
Bluetooth on Linux 5.13/5.14
The AX210 Bluetooth controller does not appear to work as expected when using 5.13 or 5.14 (current as of 5.14.7), tested with
bluetoothctl list. Here is the upstream bug report: https://bugzilla.kernel.org/show_bug.cgi?id=213829. AX210 Bluetooth works on 5.14 with cold boots, but the controller disappears after a warm boot. If necessary, downgrade to 5.12.15 for working Bluetooth support, or use a Bluetooth controller that is known to work, such as the AX201.
This issue is resolved with 5.15.4 .
Two/Three finger clicks
By default, the touchpad provides middle and right click by clicking on specific regions (bottom middle for middle click and bottom right corner for right click). To switch this two-finger click for right click and three-finger click for middle click, you will need to set the "click method" via libinput. First, find your "Touchpad" device name:
And then set the click method, where
device is the name (or ID) found in the previous step:
$ xinput set-prop "device" "libinput Click Method Enabled" 0 1
To make this persistent, put it in a startup script. Alternatively, if using X11, one can create a custom Xorg configuration file with the appropriate settings (see libinput#Via Xorg configuration file).
Dealing with HiDPI with a classic X11 window manager
If you are not using a desktop environment and are just rolling with an old school X11 window manager that does not support HiDPI, it is likely that Framework's default resolution will make things too small. Fixing this generally requires playing whack-a-mole. For "modern" GUI applications that use GTK or Qt, you can set environment variables that will generally make most things work:
$ export GDK_DPI_SCALE=1.5 $ export QT_SCALE_FACTOR=1.5
For some applications, you will need to do extra work. For example, Firefox also needs to have
layout.css.devPixelsPerPx set to
about:config. Other applications, like
git gui, have no DPI settings at all because their underlying toolkits do not support it. In those cases, you will have to increase font sizes.
Changing the brightness of the monitor does not work
If you are using a tool like
/sys/class/backlight/intel_backlight. Use ( ) instead for a compatible tool that works with this laptop.
Bootmanager flashing black screen and not loading operating system
If your Framework laptop loads the bootloader and can recognize the EFI partition on your flash drive or m.2. drive, but cannot load your boot manager (it only flashes a black screen before returning to the bootloader), you must disable Secure Boot.
- Reboot holding
- Go to the Security Tab
- Secure boot defaults to ON; disable it
- Save changes and restart
Intel Wi-Fi 6E AX210 reset/ low throughput / "Microcode SW error"
Under high stress, Wi-Fi device restarts and network speeds become abysmally slow or non-responsive until disconnecting and reconnecting to WiFi network.
This issue has been observed by owners of other manufacturers' laptops (not just framework). 
Disabling IEEE 802.11ax seems to be a suitable workaround for the time being. 
options iwlwifi disable_11ax=Y
Fingerprint Reader Device Disconnected Error
When the fingerprint reader has been used to enroll a fingerprint on Windows, and you later attempt to use the reader under Linux without first unenrolling your print from within Windows,
fprintd can fail to work. In this situation, upon enrolling with
fprintd-enroll, the command will hang, as
fprintd has crashed.
The best way to deal with this, if you still have access to Windows, is to boot back in and unenroll your fingerprint from there. If this is not possible, you can try a script posted by someone on the Framework laptop forums.
The following docking station(s) work 100% out of the box with no additional configuration:
|Name||Model Number||Interface||Power Delivery?||Notes|
|Hyper Drive Power 9-in-1 USB-C Hub||
||USB-C||Yes||Needs to be reconnected if power is removed while connected.|
|Anker PowerExpand 13-in-1 USB-C Dock||
|ThinkPad Thunderbolt 3 Dock||
||USB-C||Yes||Dock Power button does not work properly to boot the laptop|
|Dell USB-C Dock||
|OWC Thunderbolt 3 Dock||
|uni 8-in-1 USB-C Hub||
||USB-C||Yes||Short removable cable can be replaced; the Spigen USB 4 cable works.|