Skip to content

Getting Started

FrostByte-OS edited this page Aug 23, 2025 · 3 revisions

You'll have two options:

  • Downloading the prebuilt ISO
  • Building it yourself

Option 1: Prebuilt

Simply download it here and then put it on a bootable USB using a program of your choice

This is easier.

Option 2: Building

Dependencies

  • i686-elf-gcc
  • nasm
  • qemu-system-i386 (optional, but if you want make run to work)

installing dependencies

i686-elf-gcc

mkdir -p "$HOME/opt/i686-elf-tools"
cd "$HOME/opt/i686-ekf-tools"
wget https://github.com/lordmilko/i686-elf-tools/releases/download/latest/i686-elf-tools-linux.zip
unzip i686-elf-tools-linux.zip
echo 'export PATH="$HOME/opt/bin/i686-elf-tools/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

make sure it's installed

i686-elf-gcc --version

NASM

simply put

sudo apt install nasm

QEMU (optional)

Run

sudo apt install qemu-utils qemu-system-x86 qemu-system-gui

Building

Just run

git clone https://github.com/FrostByte-OS/FrostByteOS.git
cd FrostByteOS
make

and then you'll have frostbyteos.iso if you want a shorthand to run it

make run

Clone this wiki locally