{"id":19704321,"url":"https://github.com/returninfinity/baremetal-os","last_synced_at":"2025-05-15T03:08:49.691Z","repository":{"id":9058671,"uuid":"10826561","full_name":"ReturnInfinity/BareMetal-OS","owner":"ReturnInfinity","description":"Build script for BareMetal OS and its related utilities","archived":false,"fork":false,"pushed_at":"2025-05-04T22:17:24.000Z","size":645,"stargazers_count":748,"open_issues_count":0,"forks_count":106,"subscribers_count":43,"default_branch":"master","last_synced_at":"2025-05-04T23:27:23.319Z","etag":null,"topics":["baremetal-os"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ReturnInfinity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-06-20T18:28:03.000Z","updated_at":"2025-05-04T22:17:28.000Z","dependencies_parsed_at":"2023-11-19T22:24:53.385Z","dependency_job_id":"6cb6c969-706f-4599-b1c7-b559f8dbaa06","html_url":"https://github.com/ReturnInfinity/BareMetal-OS","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReturnInfinity%2FBareMetal-OS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReturnInfinity%2FBareMetal-OS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReturnInfinity%2FBareMetal-OS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ReturnInfinity%2FBareMetal-OS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ReturnInfinity","download_url":"https://codeload.github.com/ReturnInfinity/BareMetal-OS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254264771,"owners_count":22041794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["baremetal-os"],"created_at":"2024-11-11T21:21:58.311Z","updated_at":"2025-05-15T03:08:44.681Z","avatar_url":"https://github.com/ReturnInfinity.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"images/BareMetal OS - Light.png#gh-light-mode-only\"\u003e\u003c/img\u003e\n\t\u003cimg src=\"images/BareMetal OS - Dark.png#gh-dark-mode-only\"\u003e\u003c/img\u003e\n\t\u003cimg src=\"images/Screenshot.png\"\u003e\u003c/img\u003e\n\u003c/p\u003e\n\n[Discuss this project here](https://github.com/ReturnInfinity/BareMetal-OS/discussions)\n\n[![CI](https://github.com/ReturnInfinity/BareMetal-OS/actions/workflows/main.yml/badge.svg)](https://github.com/ReturnInfinity/BareMetal-OS/actions/workflows/main.yml)\n\n**BareMetal OS** is an exokernel-based operating system crafted entirely in x86-64 assembly and is designed to provide unparalleled levels of flexibility and efficiency. By exposing hardware resources directly to applications, it empowers developers to finely tune and optimize their software for specific tasks. With the exokernel's minimalist design, it minimizes the overhead imposed by traditional operating systems, enabling applications to achieve peak performance. Its x86-64 assembly implementation speaks to its commitment to squeezing every ounce of performance from the hardware, making it a compelling choice for those who demand the utmost control and efficiency from their computing environments.\n\n\u003e [!NOTE]\n\u003e\n\u003e **BareMetal OS** is under active development. Some physical hardware configurations may not work correctly.\n\n### Table of Contents\n\n- [Prerequisites](#prerequisites)\n- [Components](#components)\n- [Supported hardware](#supported-hardware)\n- [Initial configuration](#initial-configuration)\n- [Building the source code](#building)\n- [Installing](#installing)\n  - [Installing the system](#installing-the-system)\n  - [Installing the demos](#installing-the-demos)\n- [Running on a virtual system](#running-on-a-virtual-system)\n  - [QEMU](#qemu)\n  - [QEMU via UEFI](#qemu-via-uefi)\n  - [QEMU - Second Instance](#qemu-second-instance)\n  - [VMware](#vmware)\n  - [VirtualBox](#virtualbox)\n  - [Bochs](#bochs)\n- [Running on a physical system](#running-on-a-physical-system)\n\n\n# Prerequisites\n\nThe script in this repo depends on a Debian-based Linux system like [Ubuntu](https://www.ubuntu.com/download/desktop) or [Elementary](https://elementary.io). macOS is also supported to build and test the OS, as well as the Assembly applications, if you are using [Homebrew](https://brew.sh).\n\n- [NASM](https://nasm.us) - Assembly compiler to build the loader and kernel, as well as the apps written in Assembly.\n- [QEMU](https://www.qemu.org) - Computer emulator if you plan on running the OS for quick testing.\n- [GCC](https://gcc.gnu.org) - C compiler for building C/C++ applications.\n- [Git](https://git-scm.com) - Version control software for pulling the source code from GitHub.\n- [mtools](https://www.gnu.org/software/mtools/) - Utilities to access DOS (FAT32) disk images in Unix.\n\nIn Linux this can be completed with the following command:\n\n\tsudo apt install nasm qemu-system-x86 gcc git mtools\n\nIn macOS via Homebrew this can be completed with the following command:\n\n\tbrew install nasm qemu gcc git mtools\n\n \n# Components\n\nBareMetal OS consists of several different projects:\n\n- [Pure64](https://github.com/ReturnInfinity/Pure64) - The software loader.\n- [BareMetal](https://github.com/ReturnInfinity/BareMetal) - The kernel.\n- [Monitor](https://github.com/ReturnInfinity/BareMetal-Monitor) - A simple command line interface.\n- [BMFS](https://github.com/ReturnInfinity/BMFS) - The BareMetal File System utility.\n- [BareMetal-Demo](https://github.com/ReturnInfinity/BareMetal-Demo) - Various demo programs.\n\n\n# Supported Hardware\n\n* CPU\n  * Multi-core on 64-bit x86 systems (Intel/AMD)\n* Bus\n  * PCIe\n  * PCI\n  * xHCI (USB 3)\n* Network\n  * Gigabit\n    * Intel 8254x Gigabit (e1000)\n    * Intel 8257x Gigabit (e1000e)\n    * Intel 8259x 10 Gigabit (ixbge)\n    * Realtek 816x/811x Gigabit (rtl8169)\n  * Virtual\n    * Virtio-Net\n* Storage\n  * NVMe\n  * AHCI (SATA)\n  * IDE\n  * Virtio-Blk\n* HID (Human Interface Devices)\n  * PS/2 Keyboard\n  * PS/2 Mouse\n  * USB Keyboard\n\n\n# Initial configuration\n\n\tgit clone https://github.com/ReturnInfinity/BareMetal-OS.git\n\tcd BareMetal-OS\n\t./baremetal.sh setup\n\n`baremetal.sh setup` automatically runs the build and install functions. Once the setup is complete you can execute `baremetal.sh run` to verify that everything installed correctly.\n\n\n# Building\n\n\t./baremetal.sh build\n\nThis command builds the boot sector, loader (Pure64), kernel, and simple command line interface (Monitor) to the disk image. If you want to attach your own binary to the end of the kernel you can use `./baremetal.sh build mybinary.bin`\n\n# Installing\n\n## Installing the system\n\n\t./baremetal.sh install\n\nThis command installs the software to the disk image.\n\n## Installing the demos\n\n\t./baremetal.sh demos\n\nThis command installs the demo programs to the disk image.\n\n\n# Running on a virtual system\n\n## QEMU\n\n\t./baremetal.sh run\n\n## QEMU via UEFI\n\t\n\t./baremetal.sh run-uefi\n\n## QEMU - Second Instance\n\n\t./baremetal.sh run-2\n\nRunning a cloned second instance is useful for testing network connectivity between QEMU systems.\n\n## VMware\n\n\t./baremetal.sh vmdk\n\n## VirtualBox\n\n\t./baremetal.sh vdi\n\nNotes:\n- The VDI script rewrites the disk ID of the VDI file to avoid the disk warning in VirtualBox.\n- The `Chipset Type` for the VirtualBox VM must be `ICH9`\n- The `Storage Controller` should be `ACHI (SATA)` or `NVMe (PCIe)`\n\n## Bochs\n\n\tbochs -f bochs.cfg\n\nNotes:\n- The `bochs.cfg` file may need to be adjusted for your usage. It was created for a Linux-based system.\n- `display_libary` is set to use `x` for X Windows with the GUI Debugger by default. On macOS or Windows you will need to use `sdl2` with no additional options.\n- The file paths for `romimage` and `vgaromimage` will need to be updated if the Bochs BIOS files are in a different location.\n\n\n# Running on a physical system\n\nBooting via BIOS and UEFI is supported. Secure boot in UEFI mode must be disabled since this software isn't signed. You may need to press \u003ckbd\u003eDEL\u003c/kbd\u003e or \u003ckbd\u003eF12\u003c/kbd\u003e on the keyboard on power-up to select the boot drive.\n\nDebug logging is output via the serial port (115200 bps, 8 data bits, 1 stop bit, no parity, no flow control). The output should look similar to this:\n```\n[ Pure64 ]\nboot bios\npml4 ok\nacpi ok\nbsp ok\npic ok\nsmp ok\nkernel start\n\n[ BareMetal ]\n64\nbus\nnvs\nnet\nsystem ready\n```\n\n\u003e [!IMPORTANT]\n\u003e Booting from a floppy or USB drive works. For BIOS-based floppy boot and UEFI-based USB drive booting there is a RAM drive image loaded that contains the demo programs.\n\n\u003e [!CAUTION]\n\u003e Doublecheck that you are writing the disk image to the correct disk\n\n\tdd if=baremetal_os.img of=/dev/sdc\n\nOnce the disk image is written you can install the disk in the system and boot from it.\n\n\n// EOF\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freturninfinity%2Fbaremetal-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freturninfinity%2Fbaremetal-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freturninfinity%2Fbaremetal-os/lists"}