Gloire is an OS built with the Ironclad kernel and using GNU tools for the userland, along with some original applications like util-ironclad. This repository holds scripts and tools to build the OS from the ground up on a Linux-based system.

Gloire is named after the french ironclad, which was the first ocean-going vessel of its kind.

One can grab a pre-built Gloire image here.

One can run either the downloaded disk image (uncompressing it first) or a built image with an emulator like QEMU. For using QEMU with an x86_64 image, one can do:

qemu-system-x86_64 -enable-kvm -cpu host,migratable=off -m 8G -M q35 -drive format=raw,file=gloire.img -serial stdio

Where gloire.img is your image of choice.

To do the same with a riscv64 image, you can do:

qemu-system-riscv64 -M virt,acpi=on -cpu rv64 -device ramfb -device qemu-xhci \
  -m 4G -device usb-kbd -device usb-mouse -serial stdio \
  -drive if=pflash,unit=0,format=raw,file=<firmware image> \
  -drive id=disk,file=gloire.img,if=none -device ahci,id=ahci \
  -device ide-hd,drive=disk,bus=ahci.0

For riscv64, firmware can be obtained from the EDK2 project, and must be prepared as per QEMU with a

dd if=/dev/zero of=<firmware path> bs=1 count=0 seek=33554432

usermod -aG kvm <user>

Gloire should run fine on any x86 machine, be it UEFI or BIOS. For running it, one can burn your gloire image (uncompressing it first if downloaded) to a SATA or NVMe drive.

Gloire accepts contributions for new packages or any other kind of changes using the pull request system baked into Codeberg. Check our contribution information.

You can visit our list of community channels on Ironclad's community tab.

A list of the tools needed for compilation of the OS are:

• POSIX-compatible sh, awk, a working cc, find, free (usually from procps), git, GNU make, grep, gzip, perl, pkg-config (or pkgconf), tar, unshare (from util-linux), wget, xargs (usually from findutils), zstd, libarchive(-dev), libssl(-dev)/openssl(-dev), and zlib(-dev) (AKA zlib1g-dev on Debian-based distros) for Jinx.
• sgdisk (from the gdisk or gptfdisk package) for building the final disk image.
• qemu for testing, if wanted.

The project uses jinx as its build system, which is included in the tree. The instructions to build an x86_64 system are:

mkdir build-x86_64 && cd build-x86_64
PKGS_TO_INSTALL="*" ../build-support/makeimg.sh

unshare: write failed /proc/self/uid_map: Operation not permitted

sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0

sudo sh -c 'echo "kernel.apparmor_restrict_unprivileged_userns = 0" >/etc/sysctl.d/99-userns.conf'

The image size will default to 4G, this may be too big or too small for the selection of packages the user may have built the image with. To change this value, use the environment variable IMAGE_SIZE.

To build the riscv64 port, one can instead use:

mkdir build-riscv64 && cd build-riscv64
PKGS_TO_INSTALL="*" ../build-support/makeimg.sh

Regardless of architecture, if, instead of building all packages, building a minimal command-line only environment is desired, instead of "*", one can pass "" (or a list of desired packages, base is implied) as PKGS_TO_INSTALL.

Any of those routes will generate a bootable disk image that can be burned to storage media or be booted by several emulators.

A non-exhaustive list of the licenses used by the software ported to Gloire is:

• GPLv3 (Or-Later and Only)
• GPLv2 (Or-Later and Only)
• The Less License
• MIT License
• BSD 2-Clause

• Mintsuki for the Limine Bootloader and Jinx.
• The Managarm Project for help with some of the recipes and mlibc.