![]() |
5 rokov pred | |
---|---|---|
.github | d1ab15432b Change job order: make repo depend on release | 5 rokov pred |
keys | ec0c9b8a9f Package signing. | 5 rokov pred |
patches | ab2c76bfe8 Update patches | 5 rokov pred |
pkg | aa4b089d8d Rebase Fedora 31 to 5.5 | 5 rokov pred |
root | 54247faf82 sleep-script: IPTS: fix paths change | 5 rokov pred |
README.md | e87098afa4 README: add Surface 3 to the Supported Devices list | 5 rokov pred |
setup.sh | 523db8d6da Update setup.sh to stop installing firmware and prefer the package. | 5 rokov pred |
surface.config | b49fc24942 Enable IPTS module for v5.5 in config | 5 rokov pred |
Linux running on the Microsoft Surface devices. Follow the instructions below to install the latest kernel and config files.
See the feature matrix for more information about each device.
For a more detailed installation and setup guide, please refer to the corresponding Wiki page. There, you may also find device-specific caveats. A short overview of the process is provided below.
Releases are provided for both Debian and Arch Linux based distributions, but if you're running Arch, you may want to consider looking at this project instead, or here if you're running Fedora. These releases can be found here: https://github.com/linux-surface/linux-surface/releases.
You may also want to consider setting up one of the package repositories to obtain automatic updates.
After the installation, you should have a look at the post-installation notes, specifically you may want to set up secure-boot and install the proprietary firmware package (usually named linux-firmware
) if you have not done so already.
Before you can actually start, you will need to install some required packages. On Debian based distributions, you can do this by simply running
sudo apt install git
Clone this repository.
To save some time, you can use the --depth 1
flag.
git clone --depth 1 https://github.com/linux-surface/linux-surface.git
If you want to update this git repository later on, e.g. for re-running the setup.sh
script, you can simply run git pull
inside the repository.
Next, change into the linux-surface
directory (cd linux-surface
) and run the setup script via
sudo ./setup.sh
Follow the instructions and make your choices.
Download and install the required packages. You can use one of the package repositories to install the kernel and libwacom package.
Alternatively, you can also install them manually via (for Debian) after downloading these files from the releases section of this repo.
sudo dpkg -i linux-headers-[VERSION].deb linux-image-[VERSION].deb linux-libc-dev-[VERSION].deb
uname -a
before opening any issues.
This should give you a version string containing surface
.
If not, you may need to configure your bootloader.
For this, please refer to the instructions provided by your bootloader and/or distribution.If you want to compile the kernel yourself (e.g. if your distribution is not supported), please have a look at the wiki.
If you have questions or need support, please use our Gitter Community!
For development related questions and discussions, please consider joining our IRC channel on freenode (freenode/##linux-surface
) or the equivalent Matrix bridge.