Set Up Framework Laptop

How to install and set up Zorin OS on a Framework Laptop.

All Framework Laptop models should be compatible with the latest version of Zorin OS. As a result, you can install Zorin OS normally on your Framework Laptop.

View how to install Zorin OS ›

For the best experience, we recommend that you regularly install the latest updates from the Software Updater in Zorin OS and install the latest BIOS firmware from Framework:

View how to install BIOS firmware updates (instructions for Ubuntu) ›

Framework Laptop 13

Display scaling

If the default user interface is too large or too dense, you can adjust its scaling by opening Zorin Menu → Settings → Displays and selecting a different option for the “Scale” setting.

If neither 100% nor 200% scaling suits you, you can switch on “Fractional Scaling” to access more options in between.

Fingerprint Reader

The fingerprint reader should work out of the box. You can enable it by opening the Zorin Menu → Settings → Users and clicking on the “Fingerprint Login” option for your user account.

If you aren’t able to enroll your fingerprint in Zorin OS – but previously used the fingerprint reader in another operating system – please follow these instructions ›

If you see the error message Sensor: Failed to communicate with the fingerprint reader while enrolling your fingerprint, please follow the steps in this guide (instructions for Ubuntu) ›

Ambient light sensor or brightness & airplane mode keys

If you have the Intel Core 12th or 13th Generation Mainboard, you may only be able to either have the ambient light sensor (for automatic screen brightness adjustment) or brightness up/down (for manual screen brightness adjustment) & airplane mode keys working, but not both at the same time. You can find a technical explanation for this here.

By default, the ambient light sensor is enabled, but if you wish to enable the brightness & airplane mode keys instead, please open the Terminal (Ctrl+Alt+T) and enter these 2 commands:

echo "blacklist hid_sensor_hub" | sudo tee /etc/modprobe.d/framework-als-blacklist.conf
sudo update-initramfs -u

Afterward, restart your laptop to apply the changes.

Battery Life on Suspend

If you are noticing high battery depletion while your laptop is suspended, you can enable a workaround to get the best battery life while suspended:

  1. Open the Zorin Menu → Utilities → Terminal.

  2. Enter the following command into the Terminal:

    gedit admin:///etc/default/grub
    
  3. In the new Text Editor window, move the cursor to the line that looks like the following:

    GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"
    
  4. Add the text nvme.noacpi=1 after quiet splash so this line looks like the following:

    GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nvme.noacpi=1"
    
  5. Save the file and close the Text Editor window.

  6. Enter the following command into the Terminal:

  7. Restart the laptop to apply this change.

While testing this workaround on our Framework Laptop 13 (with an Intel Core 11th Generation Mainboard) on Zorin OS 16.1, we achieved the following results:

TimeWithout workaroundWith workaround
Start98%98%
1 hour95%96%
2 hours92%94%

The workaround causes the battery to deplete by 2% per hour instead of 3% per hour (without the fix). It appears that there is an improvement, albeit a slight one.

For additional tips to optimize battery life on the Framework Laptop 13, check out this thread. However, we only recommend making these modifications to your system if you’re an advanced Linux user.

On AMD Ryzen 7040 Series

The following instructions are based on recommendations from the Framework team. The Zorin OS team has not verified these instructions for accuracy on this hardware.

Allow both CPU and platform drivers to be simultaneously active

For improved power management, please open the Zorin Menu → Utilities → Terminal and enter these two commands:

sudo add-apt-repository ppa:superm1/ppd
sudo apt update && sudo apt upgrade -y

Afterward, restart your laptop to apply the change.

If you are experiencing graphical artifacts

Please follow the steps outlined in this guide ›

Suspend with lid closed while attached to power

If you experience a bug that creates a bogus key press when you suspend your laptop, you can apply a workaround for this by opening the Zorin Menu → Utilities → Terminal and entering this command:

sudo sh -c '[ ! -f /etc/udev/rules.d/20-suspend-fixes.rules ] && echo "ACTION==\"add\", SUBSYSTEM==\"serio\", DRIVERS==\"atkbd\", ATTR{power/wakeup}=\"disabled\"" > /etc/udev/rules.d/20-suspend-fixes.rules'

Afterward, restart your laptop to apply the change.

Wi-Fi dropouts from Wi-Fi 6E networks

If you have a Framework Laptop 13 AMD Ryzen model with a MediaTek wireless chip and experience dropouts from Wi-Fi 6E networks, please open the Zorin Menu → Utilities → Terminal and enter this command:

sudo add-apt-repository "deb http://archive.ubuntu.com/ubuntu/ jammy-proposed main restricted universe multiverse"  && sudo apt update && sudo apt install linux-firmware/jammy-proposed && sudo sed -i 's/^deb http:\/\/archive.ubuntu.com\/ubuntu\/ jammy-proposed/# &/' /etc/apt/sources.list && sudo apt update && sudo rm /lib/firmware/mediatek/WIFI_MT7922_patch_mcu_1_1_hdr.bin && sudo rm /lib/firmware/mediatek/WIFI_RAM_CODE_MT7922_1.bin && cd /tmp && wget https://gitlab.com/kernel-firmware/linux-firmware/-/raw/0a18a7292a66532633d9586521f0b954c68a9fbc/mediatek/WIFI_MT7922_patch_mcu_1_1_hdr.bin && wget https://gitlab.com/kernel-firmware/linux-firmware/-/raw/0a18a7292a66532633d9586521f0b954c68a9fbc/mediatek/WIFI_RAM_CODE_MT7922_1.bin && sudo mv WIFI_MT7922_patch_mcu_1_1_hdr.bin /lib/firmware/mediatek/ && sudo mv WIFI_RAM_CODE_MT7922_1.bin /lib/firmware/mediatek/ && sudo update-initramfs -u

Afterward, restart your laptop to apply the change.

Framework Laptop 16

Coming soon.

Special thanks

Special thanks to the Framework team for kindly providing us with a Framework Laptop 13 with Intel Core 11th & 12th Generation Mainboards for testing!