Install Arch Linux or rescue your Linux installation on Surface even without external mouse or keyboard.

This live image and all the files in this repository are distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

This live image uses linux-surface. The compatibility of linux-surface is described here.

• Copy squashfs to RAM at boot
• GNOME Shell and a few GNOME applications
• Improved Onscreen Keyboard
• Use timeshift to restore your system
• Battery status display
• Auto screen rotation support
• fish as default shell
• Symbols and CJK fonts support
• Bootable with Ventoy

You can download the ISO from Releases, or build it with the following commands:

$ git clone --recursive https://github.com/SamLukeYes/archiso-surface
$ sudo mkarchiso -v -w /path/to/work_dir -o /path/to/out_dir archiso-surface

For technical details, see ArchWiki

See ArchWiki. Please note that this ISO is only designed for UEFI.

For Arch Linux Installation Guide, please refer to ArchWiki. Here are some additional notes.

archiso-surface uses NetworkManager

Since April 2021, reflector in archiso-surface will not run automatically. You can run it at your option.

archiso-surface uses gedit instead of nano

Follow this guide to install necessary packages for your hardware to function. To make touchscreen actually usable in your new system, don't forget to set up graphical user interface. You can do this in chroot, so that you don't have to boot into a system without touchscreen support.

If you have existing snapshots created by Timeshift on your disk, you can use the Gtk interface of Timeshift to restore your system. Simply skip the initial configuration, select a snapshot, and restore it.

Since GNOME 40, automatic screen rotation cannot be enabled when a mouse is connected.

If you want to enable bluetooth again, try turning it on in Settings. If it doesn't work, restart bluetooth.service.

This might be a new behavior of GNOME 40. If you need to use the OSK with a mouse, please enable it in Accessibility Settings.

See this issue.