A cross-platform build system for creating iOS, macOS, Linux, and Windows programs.

Installation instructions for Linux & Windows

This guide will help you install Theos on your Linux machine, Windows machine via Windows Subsystem for Linux, or a Google Cloud Shell instance.

Platform Minimum OS version Targets supported
Linux Linux kernel 3.16 Linux, iOS
Windows 10/11 Windows 10 build 14393 Linux, iOS

Unless otherwise stated, all of the commands shown in the following instructions are meant to be run as a normal user, not root. Similarly, Theos is meant to be run as a normal user, not root.

  1. If you are running on Windows and haven’t already installed a Linux distribution, follow Microsoft’s instructions to do so.

  2. Install the following prerequisites1 as root:

    • Debian-based distros (includes Ubuntu, Pop!_OS, etc.)

        apt install bash curl sudo
    • Arch-based distros (includes Manjaro, EndeavourOS, etc.)

        pacman -S --needed bash curl sudo
    • Red Hat-based distros (includes Fedora, CentOS, etc.)

        dnf install bash curl sudo
    • SUSE-based distros (includes openSUSE, etc.)

        zypper install bash curl sudo

    1 In order to use sudo, your non-root user may need to be added to the sudoers file (/etc/sudoers). See ArchWiki for more information.

  3. Run the installer:

     bash -c "$(curl -fsSL"