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.
NOTE: This is an Officially Supported Linux Distribution. Learn more here.
Tools
No tools specified.
Parts
-
-
First, download the latest Ubuntu 22.04 LTS Desktop image 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.
-
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.
-
-
-
Download this Ubuntu software package to do the following for your 12th Gen Framework:
-
This package is best suited for those who do not wish to follow the next step of steps and do the following manually - this will get your Ubuntu where it needs to be automatically. Install, run the software, then reboot. Just run ubuntu-setup-tool from Activities.
-
This software ensures your wi-fi, brightness keys, headphone jack, Wayland fractional scaling, and nvme power saving runs smoothly. This also installs a NEW recommended OEM kernel.
-
-
-
Install the recommended OEM kernel and Wi-Fi power saving correction to prevent drop-offs.
-
Provide a workaround needed (SN750 for example) to get the best suspend battery life for SSD power drain.
-
Disable the ALS sensor (Ambient Light Sensor) so that your brightness keys work.
-
Enable fractional scaling for Ubuntu and Enable headset mic input.
-
-
-
Download this Ubuntu software package to do the following for your 11th Gen Framework:
-
This package is best suited for those who do not wish to follow the next step of steps and do the following manually - this will get your Ubuntu where it needs to be automatically. Install, run the software, then reboot. Just run ubuntu-setup-tool from Activities.
-
This software ensures your wi-fi, headphone jack, Wayland fractional scaling, and nvme power saving runs smoothly. This also installs the recommended OEM kernel.
-
-
-
This is for 11th Gen ONLY. Copy the entire text block provided in the gist embed on the left, paste into the terminal, press enter and type your user's password as prompted. Text to paste is labeled under *****COPY AND PASTE THIS CODE BELOW*****
-
Install the recommended OEM kernel and Wi-Fi power saving correction to prevent drop-offs.
-
Provide a workaround needed (SN750 for example) to get the best suspend battery life for SSD power drain.
-
Enable fractional scaling for Ubuntu and Enable headset mic input.
-
-
-
Expecting two-finger right clicking and need help? The touchpad help guide is here.
-
Please visit our troubleshooting guide first.
-
If you need additional help, feel free to visit our active support community.
-
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.
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.
Cancel: I did not complete this guide.
14 other people completed this guide.
11 Comments
The all-in-one-line command changes settings for Wi-Fi power saving, but the one-at-a-time commands do not include this.
The linux-generic-hwe-22.04
package has pulled in a kernel that looks newer than the one provided by linux-oem-22.04
-
linux-modules-5.19.0-35-generic
vs. linux-image-5.17.0-1028-oem
Which one should we be using on the 12th gen Framework?
We test against and recommend the kernel recommendation shown in the guide. Writing it vague as a,b, and c OEM kernels may play out later.
Hit 2 problems:
1. Installing Ubuntu 22.04 from a USB Type C drive was failing, because the Live Ubuntu kept unmounting the drive, so looks like support for USB C for a Live Linux doesn't work yet.
a. Solution: I connected my USB Type C drive to a USB type A adapter, and used the USB type A port to install Ubuntu successfully
2. Using a USB type A in the bottom right port while plugging in a USB drive disabled the wifi adapter!!!
a. Solution: I moved the USB type A port to the left side, and the wifi adapter started working...
Wonderful. Any reports on whether this bug from 22.04 is addressed by the newer linux kernel in 22.10? It’s so severe, it doesn’t let one use the USB ports at all. https://bugs.launchpad.net/ubuntu/+sourc...