Getting Started

February 9, 2026 ยท View on GitHub

Install Packages

Install the following packages:

  • Rustup
  • Bun
  • QEMU (brew install qemu or apt install qemu)

Tip

Can I use Windows?

Yes, it should just work on Windows. That said, I recommend using WSL2 (Ubuntu) for good performance and ease of setup.

Running FTL

To build and run the OS, run:

bin/ftl run

Note

To exit QEMU, type Ctrl+A then X. Or C to enter QEMU monitor (debug console).

Auto Restarting

To automatically rebuild and restart the OS when you make changes, run:

bin/ftl dev

Note

To exit, type Ctrl+C.