Framework Computers (Intel only)¶
Important information for AMD-based sytems
Framework recommends NOT using
tlp on the new AMD-based Framework 13. These images use
tlp, so it is currently recommended to use the non-framework images if you own an AMD Framework 13. Check the community thread for the latest information.
Follow the installation instructions to select a Framework image. These images end with
-framework in their name.
Note that the default image work fine on the Framework 13, these images provide tweaks and further improvements and are optional for people who prefer to use
tlp. These images will also work fine on non-Framework laptops.
- ublue-os/framework - repository for generating these images
Like all Universal Blue images, hardware acceleration and codecs are included out of the box and the system strives for a zero-maintenance based approach.
- Ships the recommended power profile for
- Sets the text scaling factor in GNOME to 1.25
- Some images (like Bluefin) come with fractional scaling already enabled by default. You may want to adjust those settings, however this will case Electron apps to become blurry. Setting the text font larger seems to be the "least-worst" solution available.
- Add's the following kernel arguments:
"module_blacklist=hid_sensor_hub" "nvme.noacpi=1" "tpm_tis.interrupts=0"
- Note that kernel arguments are applied with the command
just framework-13and a subsequent reboot. See the instructions below.
Additional Diagnostic Tools¶
just benchmark- will run stress-ng for 1 minute
powertop- allows you to monitor power consumption in real time
How to Help¶
Open Source succeeds best when contributors come together to solve a problem. These are areas where contributions would be appreciated:
tlpconfigurations. The image is designed to allow shipping multiple power profiles; we just need to collect and curate a set that would be the most useful for people.
- Benchmarking tools. It would be nice to be able to run a continuous benchmark that exercises the laptop and can run unattended so that we can automate power testing.
We want to allow Linux users to share this knowledge and expertise with each other to fulfill the true potential of Framework laptops. We'll use science and the wonders of modern automation to accomplish this!
- Thread on the Framework forums - general feedback welcome here, the co-creator of Bluefin "dog-foods" this image on a 13th gen Framework 13. Yes, it is glorious.
- Contributions welcome!
Run this command to set the right kernel arguments for the brightness keys to work:
and then reboot one more time! We strive to make that the last piece of operating system maintenance you'll have to do for the life of the machine.
Rebasing from another image¶
If you're rebasing from another image follow these instructions!
Rebase to the
sudo rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bluefin-framework:38
Bluefin Developer Experience:
sudo rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bluefin-dx-framework:38
Then run this command to set the right kernel arguments for the brightness keys to work:
Then reboot one more time and you're done!
Support for various other Framework laptops¶
The initial release supports the 13th generation Intel Framework 13. It is entirely possible for machine-specific tweaks to be added as part of the image. Contributions are welcome if you want to enable a specific model.