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, and we’ve worked with the team at Fedora to improve support. Fedora 37 is one of the Linux distributions we recommend most, as it has full hardware support with very little setup required, and it offers a great user experience overall.
One note on Fedora is that the distro follows a fairly aggressive update policy on new kernels. This means that if you have the most recent generation of hardware, there is a higher risk that a kernel update could have a driver regression. On older platforms, this is less of a risk. To avoid this risk altogether, you can use a more conservative distro like Ubuntu LTS.
This is an Officially Supported Linux Distribution. Learn more here.
Tools
No tools specified.
Parts
-
-
Fedora has a fantastic tool called Fedora Media Writer to create USB installers. It's available for Windows, OS X, and Linux. For Windows and OS X, you can download it here: https://getfedora.org/en/workstation/dow...
-
Insert your USB drive (2GB or larger). Note that it will be reformatted, so make sure you are ok with erasing any data that is on it.
-
After installing Fedora Media Writer, run it. Click Next to go to the "Select Fedora Release" screen. We'll proceed with the Official Fedora Workstation release for this guide, but there are a range of other options available. No click Next.
-
The latest version of Fedora will be selected by default. Make sure the correct USB Drive is selected in the drop down, and then click Write.
-
Once the USB drive creation is complete, you can click Finish, close Fedora Media Writer, eject your USB drive, and if you'd like to, delete the downloaded ISO file.
-
-
-
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 EFI USB Device item with your arrow keys and hit Enter.
-
Hit Enter again to test the media and boot into Fedora.
-
After a few seconds, you're in! If you just want to try Fedora out, you can click on the Try Fedora button and browse through the live USB version of it without touching the internal storage drive. If you do want to install Fedora to the internal storage drive, go on to the next step.
-
-
-
Click on the Install to Hard Drive button.
-
Select the keyboard language you'd like to use. On the next screen, click on the Installation Destination button to choose the disk. Note that you can install Fedora onto a USB drive or a Storage Expansion Card as an alternative to installing it onto your internal drive.
-
Click Finish Installation and then reboot into your new Fedora install!
-
-
-
Click on Start Setup button. This begins the process of completing the initial setup of your Fedora installation.
-
Connect to Wi-Fi or Skip. If you wish not to connect to wireless just yet, you can skip this and return to connecting to Wi-Fi later on.
-
Choose your Privacy settings. Here you can decide if you would like to allow Location Services using Mozilla Location Service or not.
-
Click on Enable Third-Party Repositories. Unless you have a specific reason for not doing so, it's recommended that these repositories are enabled for access to additional drivers and applications.
-
Connect Online Accounts or Skip. Connect to Google, Nextcloud or Microsoft online accounts to access your email, calendar, contacts, documents and photos.
-
-
-
If you have not done so already, follow the on-screen instructions to connect to Wi-Fi, configure some basic Fedora settings, and create a user account using a strong password you'll remember.
-
Once the user is created, make sure to update your packages using "sudo dnf upgrade" or the Software application to get the latest kernel version, which includes further improvements for the latest Intel CPUs and for the Framework Laptop specifically.
-
That's it! Wi-Fi, Bluetooth, touchpad gestures, media keys, and just about everything else works right out of the box on the latest Fedora.
-
-
-
There's one issue that is specific to systems with 12th Gen Intel Core. The ALS (ambient light sensor) & the brightness up/down keys conflict on some current kernels. You can disable the ALS to restore brightness up/down functionality with the following command (making sure you've first updated your packages to get the latest kernel available):
-
sudo grubby --update-kernel=ALL --args="module_blacklist=hid_sensor_hub"
-
-
-
Framework Ethernet expansion card on Framework laptops with TLP installed. If you notice the card isn't working on resume from suspend, please run the following in a terminal:
-
sudo lsusb
-
Look for ID 0bda:8156 Realtek Semiconductor Corp. USB 10/100/1G/2.5G, we want 0bda:8156.
-
Now back in the terminal:
-
sudo grubby --update-kernel=/boot/vmlinuz-$(uname -r) --args="usbcore.quirks=0bda:8156:k"
-
Reboot.
-
In the past, various tweaks made to the TLP config worked. During my testing, this was not longer the case and grub changes above are recommended instead.
-
-
-
Expecting different touchpad behavior? The touchpad help guide is here.
-
Need help? Please visit our troubleshooting guide first.
-
If you need additional help, feel free to visit our active support community.
-
Enjoy using Fedora on your Framework Laptop! If you have any questions or run into any issues, we recommend bringing them to the Community in the Fedora 37 topic. Members of the Framework team and sometimes the Fedora team as well participate in discussions there.
Enjoy using Fedora on your Framework Laptop! If you have any questions or run into any issues, we recommend bringing them to the Community in the Fedora 37 topic. Members of the Framework team and sometimes the Fedora team as well participate in discussions there.
Cancel: I did not complete this guide.
18 other people completed this guide.
30 Comments
Step 5, line 13 says "# Prevent a potencial Fedora freezing issue:" potential is spelled wrong.
Ah, great catch - fixing now.
Aren't the keys supposed to light up on the framework? Installed Fedora 37 and my keys nor screen brightness is working. Followed the commands to enable
Please open a support ticket.
Keys light up now, but unable to use F7/F8 to (what I assume) would be to dim/brighten the screen?
