README.md

Axol

Axol is a minimal 64-bit kernel project for learning operating system development.

⚠️ This is just a hobby project and anyone can contribute, but it probably won't get big and professional!

Screenshot of the current state

📋 Prerequisites

• A text editor such as VS Code.
• Docker for creating our build-environment.
• QEMU for emulating our operating system.

💾 Getting Started

Start by cloning the repository with: git clone --recursive https://github.com/EntenKoeniq/Axol.git

Setup

Build an image for our build-environment: docker build buildenv -t axol-buildenv

Build

Enter build environment:

• Linux or MacOS: docker run --rm -it -v "$(pwd)":/root/env axol-buildenv
• Windows (PowerShell): docker run --rm -it -v "${pwd}:/root/env" axol-buildenv

Commands

Build kernel: make

Remove all build files: make clean

To leave the build environment, enter exit.

Emulate

You can emulate Axol with QEMU and: qemu-system-x86_64 -drive format=raw,file=build/kernel.iso

Cleanup

Remove the build-evironment image: docker rmi axol-buildenv -f

📝 License

This project is licensed under Apache License 2.0