The GitHub runners usually have about 14 GB of free space. This is not enough to build a full Fedora kernel with debug symbols. Disabling the debug symbols is not an option, because they are needed to generate data for BPF programs, and because it would mean more patches to the spec file which I would like to avoid. The runners contain a bunch of software that is entirely useless for our purposes. For example, a full .NET distribution, the entire Android SDK, and a bunch of cached container images that arent Fedora. However, with GitHubs container directive it is not possible to remove these, because no custom code is ever executed on the runner itself. To execute code on the runner, the container has to be created and used manually. To simplify this, all of the actual logic has been moved to a dedicated script, similar to how the CI on iptsd is set up. |
||
---|---|---|
.github | ||
configs | ||
contrib | ||
patches | ||
pkg | ||
scripts | ||
FUNDING.yml | ||
README.md |
Linux Surface
Linux running on the Microsoft Surface devices. Follow the instructions below to install the latest kernel.
Announcements and Updates | Upstream Status
Supported Devices
- Surface Book
- Surface Book 2
- Surface Book 3
- Surface 3
- Surface Go
- Surface Go 2
- Surface Go 3
- Surface Laptop
- Surface Laptop 2
- Surface Laptop 3
- Surface Laptop 4
- Surface Laptop 5
- Surface Laptop Go
- Surface Laptop Go 2
- Surface Laptop Studio
- Surface Pro 3
- Surface Pro 4
- Surface Pro (5th Gen) / Surface Pro 2017
- Surface Pro 6
- Surface Pro 7
- Surface Pro 7+
- Surface Pro 8
- Surface Pro 9
- Surface Studio
Features / What's Working
See the feature matrix for more information about each device.
Disclaimer
- For the most part, things are tested on a Surface Book 2. While most things are reportedly fully working on other devices, your mileage may vary. Please look at the issues list for possible exceptions.
Installation and Setup
We provide package repositories for the patched kernel and other utilities.
Please refer to the detailed installation and setup guide.
There, you may also find device-specific caveats.
In case you have disk encryption set up or plan to use it, take care to follow the respective instructions in the installation guide and have a look at the respective wiki page.
After installation, you may want to have a look at the wiki and the contrib/
directory for useful tweaks.
If you want to compile the kernel yourself (e.g. if your distribution is not supported), please have a look at the wiki.
Additional Information
Notes
- If you are getting stuck at boot when loading the ramdisk, you need to install the Processor Microcode Firmware for Intel CPUs (usually found under Additional Drivers in Software and Updates).
- Using TLP can cause slowdowns, laggy performance, and occasional hangs if not configured properly! You have been warned.
- If you want to use hibernate instead of suspend, you need to create a swap partition or file, please follow your distribution's instructions (or here).
Support
If you have questions or need support, please join our Matrix Space! This space contains
- a support channel for general support and
- a development channel for all development related questions and discussions.
If you prefer IRC, you can also join in via our channel at
libera.chat/#linux-surface
, to which the matrix room is bridged to.
License
This repository contains patches, which are either derivative work targeting a specific already licensed source, i.e. parts of the Linux kernel, or introduce new parts to the Linux kernel. These patches fall thus, if not explicitly stated otherwise, under the license of the source they are targeting, or if they introduce new code, the license they explicitly specify inside of the patch. Please refer to the specific patch and source in question for further information. License texts can be obtained at https://github.com/torvalds/linux/tree/master/LICENSES.