Awesome

• About
• Getting Started
  • Prerequisites
  • Building
• Running
• Support
• Contributing
• Authors & contributors
• Security
• License
• Acknowledgements

About

AurixOS is a general-purpose operating system, meant to take security, performance and usability to the next level.

Getting Started

Latest official releases of AurixOS are available for download here.

Prerequisites

If you have Homebrew installed, simply run brew bundle to install all required build dependencies (incl. packages to build AurixOS for every supported architecture). Alternatively, read the Brewfile in the root of this repository and install the required (and optional) packages manually.

Building

To build AurixOS, simply run make in the root directory of this repository. To change the build architecture, run make ARCH=arch, where arch is the target architecture (Default is set to x86_64).

Building AurixOS images is also supported with Make recipes:

• livecd builds a CD-ROM image (.iso)
• livehdd builds a HDD image (.img)

All images reside in the release/ directory and follow this naming scheme: aurixos-live[MEDIA]-[GIT_REV]_[ARCH].iso

make help shows you all available build options

Running

To run AurixOS on QEMU, run make run (optionally, append ARCH=arch if you're building/running AurixOS on an architecture other than x86_64).

Alternatively, you can boot AurixOS on a physical machine by running dd if=release/<usb-image>.img of=/dev/<target USB drive> bs=1M and booting off of this USB drive.

Support

If you have any questions, feel free to open a GitHub issue. Alternatively, you can visit us:

• on our Discord server
• on #aurixos at irc.libera.chat (Kiwi IRC)

Contributing

First off, thanks for taking the time to contribute! Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

Please read our contribution guidelines, and thank you for being involved!

Authors & contributors

For a full list of all authors and contributors, see the contributors page.

Security

AurixOS follows good practices of security, but 100% security cannot be assured. AurixOS is provided "as is" without any warranty. Use at your own risk.

For more information and to report security issues, please refer to our security documentation.

License

This project is licensed under the MIT license.

See LICENSE for more information.

Acknowledgements

• The Standard C Library by P. J. Plauger
• Soapine Bootloader