Skip to main content
/

Site Navigation

Your Account

Choose Language

Comma

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. The Framework Laptop is running some very recent hardware, so a manual workaround is needed to get Ubuntu 21.10 working smoothly. We recommend Fedora 35 for now if you want a distro that works directly out of the box.

Tools

No tools specified.

Parts

  1. First, download the Ubuntu 21.10 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 21.10 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-21.10-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 21.10.

    • 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.

  2. There is one critical manual workaround needed to fix the touchpad behavior to prevent it from freezing occasionally.
    • There is one critical manual workaround needed to fix the touchpad behavior to prevent it from freezing occasionally.

    • As root, edit /etc/default/grub to add “i915.enable_psr=0” to the GRUB_CMDLINE_LINUX_DEFAULT line. It will then look like the following:

    • GRUB_CMDLINE_LINUX_DEFAULT="quiet splash i915.enable_psr=0"

    • Then as root run "update-grub2", and then reboot.

    • The only other hardware that doesn't work out of the box is the microphone input on the 3.5mm jack. It's an easy workaround though. As root, edit "/etc/modprobe.d/alsa-base.conf", add "options snd-hda-intel model=dell-headset-multi" to the end of it, and then reboot.

    • After installing your OS, we recommend updating to the latest Framework Laptop firmware to make sure the laptop is running at optimal performance and stability.

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 21.10 topic. Members of the Framework team participate in discussions there.

One other person completed this guide.

Nirav Patel

Member since: 03/24/2021

1,588 Reputation

14 Guides authored

Team

Framework Member of Framework

Community

4 Members

15 Guides authored

2 Comments

Add Comment

View Statistics:

Past 24 Hours: 26

Past 7 Days: 199

Past 30 Days: 412

All Time: 412