Tutorial [New 2024] Install Theos on Windows 10/11 (Subsystem for Linux)

Rook · October 27, 2023

This tutorial is outdated. Please use the updated tutorial by the official theos developers: https://theos.dev/docs/installation-linux

-----------------------------------

Instructions:
1. First of all you will need the latest Windows update, so before proceeding, check for Windows updates and make sure your Windows 10 is up to date. This tutorial only works on Windows 10.

1.1. Next, you need to open Windows PowerShell as Admin and run this command:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

2. Open the Microsoft Store app and install the Ubuntu app on your Windows.

3. Once the download has completed, select "Launch" from the Microsoft Store page and wait for the terminal Window to do it's thing.

4. When asked for a UNIX username & password, enter anything you want. Example: Username: iosgods & Password: iosgods

5. Once that is done, you now need to open CMD & type in ubuntu or just search "Ubuntu" from your start menu.

6. If done correctly so far, you will see the username you set in a green color next to your PC name (as seen in the picture above). From that terminal Window, you will need to run a few commands to get theos up and running properly. Run these in order one at a time:

Installing dependencies:

sudo apt-get update
sudo apt-get install -y build-essential git zip unzip libio-compress-perl fakeroot perl clang-6.0 libplist-utils

Setting the $THEOS variable:

https://theos.dev/docs/installation-linux

Installing Theos, Toolchain & SDK:

https://theos.dev/docs/installation-linux

And you're done! Theos is officially installed and ready to run. CD into the folder where you want your projects to be stored and run:

Notes:
- You can pin the Ubuntu terminal on your taskbar or create a desktop shortcut for easier access.
- Your projects and whole Ubuntu file system is located in: C:\Users\%USERNAME%\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_xxxxxx\LocalState\rootfs. Your projects are usually stored inside the /home folder.
- You can set root as the default user by running this command in CMD: ubuntu config --default-user root - It's better to login and always use root because of how drag and dropping via Explorer works. If you are going to use root always, you need to run the "setting $THEOS variable" part of the tutorial again as root user. It is actually highly suggested you do this because things might not work properly if you're not root.
- To use make package install you need iFunBox's USB Tunnel running & your iDevice connected via USB. Then run echo export "THEOS_DEVICE_IP=localhost THEOS_DEVICE_PORT=23" >> ~/.bashrc in your terminal window.
- You can add extra helpful aliases by running commands like: echo 'alias mpi="make package install"' >>~/.profile && source ~/.profile so when you want to make and install your package, you can simply run 'mpi' command.
- To install theos on your iDevice, see this topic.

Useful links:
https://docs.microsoft.com/en-us/windows/wsl/install-win10
https://docs.microsoft.com/en-us/windows/wsl/user-support
https://docs.microsoft.com/en-us/windows/wsl/wsl-config
https://github.com/theos/theos/wiki/Installation
https://github.com/theos/theos/wiki/NIC

Updated October 27, 2023 by Rook
Updated commands, improved installation

chaos2nirvana · December 12, 2017

wow,for 2018. thx DiDA. well I still use win7 tho

Rook · December 12, 2017

On 12/12/2017 at 2:22 AM, chaos2nirvana said:

wow,for 2018. thx DiDA. well I still use win7 tho

Expand

2018 part is clickbait since we're still in 2017.

chaos2nirvana · December 12, 2017

On 12/12/2017 at 2:27 AM, DiDA said:

2018 part is clickbait since we're still in 2017.

Expand

gotcha.

Just noticed its a guide for installing Theos on PC but IOS. too complicated for me.

Rook · December 12, 2017

On 12/12/2017 at 2:42 AM, chaos2nirvana said:

gotcha.

Just noticed its a guide for installing Theos on PC but IOS. too complicated for me.

Expand

You can follow this for iOS, quite easy.

https://github.com/theos/theos/wiki/Installation

Updated December 12, 2017 by DiDA

Laxus · December 12, 2017

Naisuuuu

godfather9797 · December 12, 2017

Thanks @DiDA

when try to install Toolchain after download it using this command

sudo wget https://developer.angelxwind.net/Linux/ios-toolchain_clang%2bllvm%2bld64_latest_linux_x86_64.zip -O LinuxToolchain.zip

it giving me this error ( sudo: unzip: command not found )

Rook · December 12, 2017

Run sudo apt-get install unzip and try again.

Updated December 12, 2017 by DiDA

godfather9797 · December 12, 2017

Install SDK
sudo rm -rf /opt/theos/sdks/ && git clone https://github.com/theos/sdks /opt/theos/sdks

giving me
fatal: could not create work tree dir '/opt/theos/sdks': Permission denied

Rook · December 12, 2017

On 12/12/2017 at 5:09 PM, godfather9797 said:

Install SDK
sudo rm -rf /opt/theos/sdks/ && git clone https://github.com/theos/sdks /opt/theos/sdks

giving me
fatal: could not create work tree dir '/opt/theos/sdks': Permission denied

Expand