tl;dr is use the latest Fedora Respins (linked below) if you want your fingerprint reader and AX210 WiFi to work out of the box, or use Fedora 34 with an external network adapter and then
dnf upgrade to get a newer kernel and libfprint.
Huge shout out to the Fedora team for getting support into the Respins. Once F35 comes out, everything should just work out of the box with the normal download.
Installing a Fedora 34 Respin
New users who want to use Fedora on the Framework Laptop out of the box should download their images from the list of Respins. This is where the latest Fedora 34 Respins which have the updated libfprint and kernel to support AX210 are hosted. These will update roughly every two weeks as the Fedora Respin SIG releases new images. They are all vetted by the Respin SIG for basic functionality. The difference between these images and a vanilla F34 image is that these include all updates on top of base Fedora 34 up to the point of when the image is released.
- If you’re setting up a Framework Laptop DIY Edition for the first time, follow that Quick Start Guide first to set up the hardware.
- Download your preferred version of Fedora.
- Use a tool such as Fedora Media Writer to create a bootable installation USB drive.
a. If using Fedora Media Writer, when you reach “Select the Fedora Edition you wish to make a bootable USB drive for”, select “Custom image” and point Fedora Media Writer toward the Respin image you downloaded. You can also click the “…” at the bottom of the list to select one of Fedora Spins directly from Fedora Media Writer. Then, plug in the USB drive that you intend to install the image onto and select “Write to Disk”.
- Plug the drive into your Framework Laptop, and power it on while pressing F12 to access the one time boot menu.
- You can then follow the Fedora installation instructions.
- Finally you can complete your installation using the graphical installation interface. You can read detailed instructions here Installing Using Anaconda.
- After you have completed the installation, you can perform any post installation configuration After the Installation.
- Finally, don’t forget to thank the Fedora team for their amazing work, and if you would like to contribute head over to https://whatcanidoforfedora.org/
Installing Fedora 34 (non-Respin)
The default Fedora 34 image has an older kernel and libfprint which don’t support AX210 WiFi and the Framework Laptop fingerprint reader. You can still use Fedora 34, but you’ll need an external network adapter in order to connect to a network and then update your packages to get a newer kernel and libfprint.
Fedora does not enable fractional monitor scaling out of the box yet. To set 150% scaling instead of 100% or 200%, you’ll need to run the following command:
gsettings set org.gnome.mutter experimental-features "['scale-monitor-framebuffer']"
- kernel 5.11.x: Wifi doesn’t work
- kernel >= 5.12.x: Wifi works
- kernel 5.11.x: Bluetooth doesn’t work.
- kernel 5.12.x: Bluetooth works.
- kernel 5.13.x: Bluetooth doesn’t work?
- kernel 5.13.4: Bluetooth works
- kernel 5.13.6: Bluetooth works.
Fingerprint Reader - libfprint - The default Fedora 34 image doesn’t support the fingerprint reader used in Framework Laptop. The upstream fixed version is 1.92.0. However in case of Fedora 34, libfprint 1.90.7-3.f34 fixes the issue by applying a patch (the Fedora Bugzilla ticket). If you want to update the libfprint on Fedora 34, you can run
dnf upgrade libfprintor manually install by grabbing the rpm here: libfprint-1.90.7-3.fc34 | Build Info | koji. If you want to try a libfprint >= 1.92.0 Fedora 35 RPM package on Fedora 34, you can see this comment.
- Update 2021-Sept-25: Various community members have reported that libfprint v1.94.0 has been able to address a ‘hot power button’ issue.
Deep Sleep - If you see sleep issues or high power drain while sleeping, you can enable deep sleep:
echo deep > /sys/power/mem_sleep. You can also permanently enable this following the instructions here.
Trackpad Cursor Lag / Vertical Screen Tearing - One issue has been identified on both Respin & Non-Respin installs (see the post below) that shows up as trackpad cursor lag or vertical screen tearing. This is can be solved by adding a kernel command line argument that disables Panel Self Refresh on the built-in Intel video card. Run this command & reboot:
grubby --update-kernel=ALL --args="i915.enable_psr=0"
How to ask on Fedora
- If you know that your issue is about a specific RPM package, you can check if the topic is already filed on the Fedora Bugzilla by clicking rpms/package_name - Issues, and you can open an issue ticket on Fedora Bugzilla, specifying component as a RPM package.
- If you don’t know which RPM package your issue is about, but you know which category it is about, you can find the topic’s Special Interest Group (SIG) on the SIGs page, and contact from the communication channel.
- For general issue on Fedora, you can use the Ask Fedora forum.