Skip to main content
/

Site Navigation

Your Account

Choose Language

Use linux-oem-22.04

Minor Versionm

by Nirav Patel

Introduction

Once you have your Framework Laptop set up following the Quick Start Guide, you’re ready to install your preferred OS. Ubuntu 22.04 LTS works fantastically well right out of the box. WiFi and the Fingerprint Reader work automatically. With one workaround, you can also get pretty good standby battery life.

Tools

No tools specified.

Parts

  1. First, download the Ubuntu 22.04 LTS ISO from Ubuntu's website.  Ubuntu has a detailed installation guide that you can follow.  We'll go through the steps in this Guide assuming you have a simple installation scenario of a fresh install on a blank drive. Download balenaEtcher as a tool to create the USB installer from the ISO.  balenaEtcher is available for Windows, MacOS, and Linux.  You can either install it or download the portable version that runs directly from the executable.
    • First, download the Ubuntu 22.04 LTS ISO from Ubuntu's website. Ubuntu has a detailed installation guide that you can follow. We'll go through the steps in this Guide assuming you have a simple installation scenario of a fresh install on a blank drive.

    • Download balenaEtcher as a tool to create the USB installer from the ISO. balenaEtcher is available for Windows, MacOS, and Linux. You can either install it or download the portable version that runs directly from the executable.

    • Launch balenaEtcher. Insert your USB drive (8GB or larger). Click on "Flash from file" and select the ubuntu-22.04-desktop-amd64.iso that you downloaded. Click on "Select target" and choose your USB drive. Click "Flash" and wait a minute or two for it to complete.

    • Once the USB drive creation is complete, you can close balenaEtcher and eject the USB drive from your OS.

    • Insert the USB drive into your powered off Framework Laptop, and then power on. If you have an existing OS installed on the Storage drive in your laptop, you'll need to tap F12 as you boot to bring up the Boot Manager screen. You can then select the "Linpus lite" item with your arrow keys and hit Enter.

    • If you don't have an internal storage drive installed or it is blank, the laptop will boot to the USB drive directly.

    • Hit Enter again to boot into Ubuntu.

    • After a few seconds, you're in! If you just want to try Ubuntu out, you can click on the Try Ubuntu button and browse through the live USB version of it without touching the internal storage drive. If you do want to install Ubuntu to the internal storage drive, go on to the next step.

    • Click on the Install Ubuntu button.

    • Select the keyboard language you'd like to use. On the next screen, connect to your WiFi network if available. On the "Updates and other software" screen, you can keep the default selections or optionally also check the "Install third-party software" box, and click Continue.

    • On the "Installation type" screen, you may have a range of options available if there is already on OS on your internal drive. For the purposes of this guide, we're assuming a clean install with the "Erase disk and install Ubuntu" option. For the other advanced options around dual booting, you can follow Ubuntu's guide. Click continue.

    • Select your internal drive if it isn't selected, and click Install Now. Follow the on-screen instructions to select your time zone and set up your user account. After installation completes, click Restart Now.

    • Make sure to update Ubuntu to the latest packages regularly, as there are often key fixes. In Terminal, you can run "sudo apt update && sudo apt upgrade -y". You can also update using the Software Updater application.

    • With some SSDs (SN750 for one), there is also one optional workaround needed to get the best suspend battery life. If you are seeing high suspend power drain:

    • Edit /etc/default/grub as root. You can edit using a GUI by opening Terminal and running "gedit admin:///etc/default/grub &".

    • Find the line that starts with GRUB_CMDLINE_LINUX_DEFAULT, and modify it to: GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nvme.noacpi=1"

    • Save and close the file. Then in Terminal, run "sudo update-grub".

    • There are additional ways to optimize Linux battery life in this community thread.

    • After installing your OS, we recommend updating to the latest firmware (11th Gen Intel Core or 12th Gen Intel Core) to make sure the laptop is running at optimal performance and stability.

    This does not work when using UEFI boot on the framework laptop.

    Here are the related boot packages I have installed.

    efibootmgr/impish,now 17-1ubuntu2 amd64 [installed,automatic]

    grub-efi-amd64-bin/impish,now 2.04-1ubuntu47 amd64 [installed,automatic]

    grub-efi-amd64-signed/impish,now 1.173+2.04-1ubuntu47 amd64 [installed]

    grub-efi-amd64/impish,now 2.04-1ubuntu47 amd64 [installed]

    I modified /etc/default/grub as indicated to include the i915.enable line as shown below.

    GRUB_CMDLINE_LINUX_DEFAULT="quiet splash i915.enable_psr=0 mem_sleep_default=deep"

    Then I ran update-grub2 as shown below but the changes are not reflected in /proc/cmdline nor in dmesg. Any suggestions?

    Justin Vander Ziel - Reply

    • While 22.04 is mostly functional out of the box on 12th Gen Intel Core, the kernel isn't recent enough for full functionality. We have seen some issues with suspend/resume. In order to resolve these, you can optionally update to a more recent OEM kernel.

    • sudo apt-get install linux-oem-22.04

    • The ALS and the brightness up/down keys conflict on currently shipping kernels. You can disable the ALS to restore brightness up/down functionality. First, edit /etc/default/grub as root. You can edit using a GUI by opening Terminal and running "gedit admin:///etc/default/grub &".

    • Find the line that starts with GRUB_CMDLINE_LINUX_DEFAULT, and modify it to: GRUB_CMDLINE_LINUX_DEFAULT="quiet splash module_blacklist=hid_sensor_hub"

    • Save and close the file. Then in Terminal, run "sudo update-grub".

Conclusion

Enjoy using Ubuntu on your Framework Laptop! If you have any questions or run into any issues, we recommend bringing them to the Community in the Ubuntu 22.04 topic. Members of the Framework team participate in discussions there.

2 other people completed this guide.

Nirav Patel

Member since: 03/24/2021

18 Guides authored

Team

Framework Member of Framework

Community

6 Members

22 Guides authored

3 Comments

Just a heads up for the fingerprint read to work for things other than lockscreen and login you need to modify pam settings after you enroll your fingerprints.

sudo pam-auth-update

Then enable finger prints.. now u can auth sudo with a fingerprint.

disk1of5 - Reply

Add Comment

View Statistics:

Past 24 Hours: 29

Past 7 Days: 190

Past 30 Days: 781

All Time: 6,217