winesapOS <img src="https://user-images.githubusercontent.com/10150374/158224898-bdb4ad3a-ad09-478c-a09d-d313feeb8713.png" width=15% height=15%>

Game with Linux anywhere, no installation required!

[!IMPORTANT] Downloads for winesapOS can be found on our GitHub Releases page.

Performance image type:

Minimal image type:

winesapOS makes it easy to setup Linux and play games off an internal or portable external drive.

Why use winesapOS?

• Portable. Useful for gaming or recovery purposes while traveling.
• Enhanced hardware support for Apple Macs with Intel processors, ASUS ROG Ally handhelds, AYANEO handhelds, Framework Computer, Microsoft Surface laptops, and Valve Steam Deck handhelds.
• Upgrades are fully automated and supported for minor and major versions.
• All of the features of winesapOS are listed here.

Project goals:

• Readability. Anyone can learn how to install and maintain Arch Linux.
• Upstream. Stay as vanilla and upstream as possible.
• Portability. Be the most portable and modern x86_64 operating system.

Want to help support our work? Report any bugs or feature requests to our GitHub Issues. For developers, our CONTRIBUTING.md guide provides all of the information you need to get started as a winesapOS contributor. If you are a Go developer, we need the most help with the archupgrade-go project.

TABLE OF CONTENTS

• winesapOS
  • Features
    • General
    • Additional Hardware Support
      • Apple Intel Macs
      • ASUS Laptops
      • ASUS ROG Ally Handhelds
      • AYANEO Handhelds
      • Framework Computer
      • Lenovo Legion Go
      • Microsoft Surface Laptops
      • MSI Claw Handhelds
      • OneXPlayer Handhelds
      • Valve Steam Decks
    • Community Collaboration
    • winesapOS Repository
    • Comparison with SteamOS
  • Usage
    • Getting Started
      • Hardware Requirements
      • Image Types
        • Secure Image
      • Release Builds
      • Custom Builds
      • Docker or Podman Container
      • Windows Subsystem for Linux
      • Passwords
      • Mac Boot
      • Windows Boot
      • Ventoy
      • Dual-Boot
        • macOS Dual-Boot Preparation Guide
        • Windows Dual-Boot Preparation Guide
        • winesapOS Dual-Boot Install Guide
    • First-Time Setup
    • Upgrades
      • Minor Upgrades
      • Major Upgrades
    • Uninstall
    • Convert to winesapOS
  • Tips
    • Windows Games on Steam
    • Steam Deck Game Mode
    • No Sound (Muted Audio)
    • Btrfs Backups
    • VPN (ZeroTier)
  • Troubleshooting
    • Release Image Zip Files
    • winesapOS Not Booting
    • Access Boot Menu
    • Root File System Resizing
    • Read-Only File System
    • Wi-Fi or Bluetooth Not Working
    • Available Storage Space is Incorrect
    • First-Time Setup Log Files
    • Two or More Set Ups of winesapOS Cause an Unbootable System
    • Snapshot Recovery
    • Reinstalling winesapOS
    • Bad Performance on Battery
    • Bad Performance on NVIDIA
  • Frequently Asked Questions (FAQ)
  • Contributors
  • History
  • License

Features

General

• Any computer with an AMD or Intel processor can run winesapOS.
• Portability.
  • A drive is bootable on both BIOS and UEFI systems.
  • Lots of boot optimizations are made to make winesapOS more portable than most live Linux distributions.
  • Applications are installed using Flatpaks, a universal package manager for Linux, where possible.
• Persistent storage. Unlike traditional Linux live media, all storage is persistent and kept upon reboots.
  • Upon the first boot, the root partition is expanded to utilize all available space.
• Supportability. Linux is easy to troubleshoot remotely.
  • Access:
    • SSH can be accessed via clients on the same ZeroTier VPN network.
    • tmate makes sharing SSH sessions without VPN connections easy.
  • Tools:
    • ClamAV, and the GUI front-end Clamtk, is an open source anti-virus scanner.
    • QDirStat provides a graphical user interface to view storage space usage.
• Usability. Software for typical day-to-day use is provided.
  • AppImagePool for a GUI AppImage package manager.
  • asusctl = for managing ASUS computers.
  • balenaEtcher for an image flashing utility.
  • bauh for a GUI AUR and Snap package manager.
  • Blueman for a Bluetooth pairing client.
  • Bottles for installing any Windows program.
  • Calibre for managing ebooks.
  • CoolerControl for managing computer fans.
  • Discord for a gaming chat client.
  • Discover for a GUI Flatpak package manager.
  • Distrobox for managing containers.
  • Dolphin (KDE Plasma), Nemo (Cinnamon), cosmic-files (COSMIC), or Nautilus (GNOME) for a file manager.
  • FileZilla for a FTP client.
  • Firefox ESR for a stable web browser.
  • Firewall (secure image) provides a GUI for managing firewalld.
  • Flatseal for managing Flatpaks.
  • GIMP for photo editing.
  • GNOME Camera for a webcam software.
  • Google Chrome for a newer web browser.
  • GParted for managing storage partitions.
  • Gwenview (KDE Plasma), Pix (Cinnamon), cosmic-files (COSMIC), or Eye of GNOME (GNOME) for an image gallery application.
  • Kalk for a calculator.
  • KeePassXC for a cross-platform password manager.
  • LibreOffice provides an office suite.
  • Modem Manager GUI for using cellular modems.
  • mpv for HDR video playback.
  • Open Broadcaster Software (OBS) Studio for a recording and streaming utility.
  • PeaZip for an archive/compression utility.
  • qBittorrent for a torrent client.
  • Spectacle for a screenshot utility.
  • usbmuxd with backported patches to properly support iPhone file transfers and Internet tethering on T2 Macs.
  • Waydroid for Android app and gaming support.
  • VeraCrypt for a cross-platform encryption utility.
  • VLC for a media player.
  • ZeroTier GUI for a VPN utility for online LAN gaming.
• Distro-agnostic package managers for installing a large variety of software.
  • Flatpak
  • [Homebrew](https://brew.sh