Toucanix Official Building Guide

Note: All tools are intended for Ubuntu 20.04.x LTS.
Windows users must use WSL with Ubuntu 20.04.

Windows Users (WSL)

Step 1 — Install Ubuntu 20.04 LTS

1. Open the Microsoft Store
2. Search for Ubuntu 20.04 LTS
3. Install it and complete first-time setup (username/password)

Step 2 — Install build tools

Inside your WSL terminal:

cd /path/to/Toucanix
make install_required

Step 3 — Build & Run

Inside your WSL terminal:

make

Linux Users (Native Linux)

Step 1 — Install build tools

Inside your terminal:

cd /path/to/Toucanix
make install_required

Step 2 — Build & Run

make

Universal Commands

Clean

make clean

Build

make build

Run

make run

Install Required Tools

make install_required

Allow All Shell Scripts

make chmod_all

Reset OVMFbin

This is to fix that silly bug where QEMU decides to not boot.

make reset_ovmf_bin

Build & Reset OVMFbin & Run (shortcut)

make

Clean & Build & Reset OVMFbin & Run (shortcut)

make ultra