Ubuntu 21.04 on the Framework Laptop

Ubuntu 21.04 support for the Framework Laptop is mostly functional, except for the fingerprint reader due to an older version of libfprint. Note that we don’t recommend using Ubuntu 20.04 LTS, as there is missing support for WiFi out of the box.

  1. If you’re setting up a Framework Laptop DIY Edition for the first time, follow that Quick Start Guide first to set up the hardware.
  2. Download Ubuntu or your favorite Ubuntu flavor.
  3. Create a bootable USB drive on another computer.
    a. On Ubuntu
    b. On Windows
    c. On macOS
  4. Plug the drive into your Framework Laptop, and power it on while tapping F12 to access the one time boot menu. Note some users have an issue where they cannot enter the 1 time boot menu after previously booting the machine. The fix is to power off the laptop, unplug AC, wait 35 seconds, and then power on again. We’ll be resolving this in a firmware update.
  5. Select your USB drive from the list with the arrow keys and hit enter to boot the installer.
  6. You can then follow the official Ubuntu installation instructions.
  7. Don’t forget to thank the Ubuntu team for their amazing work!

Install the latest WiFi driver

Go to Linux* Support for Intel® Wireless Adapters and download iwlwifi-ty-59.601f3a66.0.tgz for Intel® Wi-Fi 6 AX210.

$ tar xf iwlwifi-ty-59.601f3a66.0.tgz

Copy the driver into place:
$ sudo cp -b iwlwifi-ty-59.601f3a66.0/iwlwifi-ty-a0-gf-a0-59.ucode /lib/firmware/


Usage notes

  • While WiFi and Bluetooth should be functional, if you see any issues, check Using the AX210 with Linux on the Framework Laptop as 21.04 is running 5.11 out of the box.
  • Deep sleep is not enabled by default. To enable, follow the instructions in this post below.
  • It’s possible to get the fingerprint reader working following the instructions here.
  • To make the 3.5mm TRRS connector support a headset with a mic, edit /etc/modprobe.d/alsa-base.conf to add this line at the end:
    options snd-hda-intel model=dell-headset-multi

Seems fairly painless. Nice!

Currently running Ubuntu 21.04 (5.11 kernel) on my i5-1135G7 Framework.

No wifi issues that I’ve noticed with the AX210 non-VPro card. Haven’t used Bluetooth.

I found that the battery drained from 100% to ~64% after 9.5 hours of sleep though (~3.8%/hr). As noted in this thread, the OS is defaulting to S2Idle when it sleeps.

So I added the following line to the /etc/default/grub file to enable deep sleep:


Edit: see better written instructions below

After doing this, it dropped from 100% to 95% after 2.5 hours of sleep (~2%/hr). That still seems a bit high to me, any suggestions?


cat /sys/power/mem_sleep and make sure it’s using deep. It should have [deep] in brackets. also cat /proc/cmdline to make sure your grub changes took.

Ok, I’ve confirmed that it is set to deep sleep.

Testing again, after 12 hours of sleep it dropped from 100% to 81% (~1.6%/hr).


Excellent, glad to hear that. Feel free to edit the wiki post (first post in this thread) with that.

1 Like

To enable deep sleep on Ubuntu 21.04 (kernel 5.11)

  1. Find the following line in the /etc/default/grub file:

  2. Change it to:
    GRUB_CMDLINE_LINUX_DEFAULT=“quiet splash mem_sleep_default=deep”

  3. Run sudo update-grub

  4. Reboot
    a. To verify, run the following from the terminal:
    cat /sys/power/mem_sleep
    b. If the output is s2idle [deep] then deep sleep is enabled (note the brackets are on “deep”)


Hi, I accidentally installed Kubuntu version 20.10 instead of 21.04, and I can’t access the internet (presumably because the version number is too low). What’s the best way to go about trying to fix this? I can’t do any updates since there is no internet connection, and when I tried to install a higher version number with a flash drive using the same technique of holding F12 I don’t go to the one time boot menu, but rather the startup web page.

1 Like

The startup key timeout is set to 0 seconds by default which doesn’t give much time to use F2 or F12.

Try running this command from terminal to reboot straight to the BIOS:
sudo systemctl reboot --firmware-setup

Then either change the Timeout to something higher or change the boot order (with the 21.04 installer is plugged in): BIOS guide


Has anyone figured out two-finger right clicks in Ubuntu 21.04? Currently, I can only right click by single finger-clicking in the lower-right-hand side of the trackpad.

I’m doing two-finger right-clicking in 21.04 right now. I didn’t have to do anything to make it work. Just tried it in a few different places/apps. Works. Wish I could be more helpful, sorry.

Double-check the mouse mode in the BIOS/EFI settings. Maybe the “auto” mode is not detecting correctly.

I got it fixed - I installed gnome-tweaks and there was a setting there for two-finger right clicks. Enabled it and it started working immediately!

sudo apt install gnome-tweaks


Thank you very much @jeshikat! I successfully installed Kubuntu 21.04 with internet working (haven’t tested it much though). It took a few tries after setting the timeout to get the usb to work, not sure if it’s because of the issue mentioned in the header post or because I was holding the key at first instead of pressing rapidly. Also the first time I tried to boot the usb drive the screen went black and didn’t make progress, after waiting a hour I turned off the device and tried again to great success.

That was likely the problem. Once you know to repeatedly tap the key it’s fairly straightforward, but honestly I prefer the Mac method of just holding a key right after startup.

The screen going black is odd, but if it’s working now that’s good!

I installed Xubuntu 21.04 on my DIY edition (i7, “no vPro” wifi), and it went mostly very smoothly. However, the biggest issue I have is that it comes out of sleep in a randomly broken state, usually to do with the mouse: things like not taking input anymore, or the speed getting really high and things like the scroll gesture stop working. I’ve not had a chance to do much deep diving into that yet, but next time I’ll check the logs for anything fishy.

The other issue I’m having is that the brightness controls aren’t doing anything, and I can’t even get a sensible looking key event in xev, but it’s possible that something is wrong with my i3 config, and if I were in xfce things would be better there, but I’m not sure; will check that too.


Made an account to chime in on this. Resume after suspend, randomly, will get in a broken state as described above.

I enabled the S2 deep workaround, and am running root ZFS encrypted. Otherwise totally stock Ubuntu 21.04 (wayland enabled).

Anyone else? I’ve had to shut down the machine instead of sleeping for now.

1 Like

I installed Ubuntu 21.04 today. According to mem_sleep mine is defaulting to deep. Verified I don’t have the setting in the /etc/default/grub. Not sure why I am seeing a different behavior. Probably worth checking step 4a before doing the rest.

1 Like

Is it showing [s2idle] deep or s2idle [deep]? Just double-checking because someone in the Fedora thread got it backwards.