In Docker
One command runs the latest version from GitHub. QEMU runs inside the container and the ari> shell appears in your terminal, with nothing to build.
Open source / Open to you
You do not need to know how to write a kernel to get involved. Try AriCodeOS, ask a question, share an idea or contribute code. There is a place for your curiosity here.
A question is a contribution, too.
Start here
Choose what interests you. You can start small and go at your own pace.
See an operating system boot from scratch. Choose Docker, a USB stick or the source code.
TalkA question, an idea or what happened on your machine. You do not need to have the answer to help.
BuildRead the guide, explore the open issues and find a first contribution that fits you.
Try it
Choose the way that suits you. The guides and commands are here when you need them.
One command runs the latest version from GitHub. QEMU runs inside the container and the ari> shell appears in your terminal, with nothing to build.
Try the USB image on a spare machine. Read the hardware guide before preparing your USB stick.
Build it with cargo xtask and run the whole QEMU test suite yourself.
docker run --rm -it ghcr.io/aricodelabs/aricodeos
# at the ari> prompt: help, ps, mem, net, dns www.aricodeos.org, http https://www.aricodeos.org/
# quit: Ctrl-A X
# Linux with KVM, faster:
docker run --rm -it --device /dev/kvm ghcr.io/aricodelabs/aricodeos \
-accel kvm -machine kernel-irqchip=splitTell us
Send a hardware report even if it stopped at the first line: knowing where it stops is exactly what helps. You only need a free GitHub account, which lets us answer you and credit you.
Stay close
Save the project with a star on GitHub, follow new releases or send the link to someone who enjoys building things. You can come back whenever you feel like taking the next step.
Contribute code
Explore issues labelled good first issue or help wanted and read the contributing guide. If you are unsure where to start, ask in Discussions. Pull requests go to develop, with tests; accepted contributors are listed in AUTHORS.md.
Every contribution has a person behind it
AriCodeOS started with one person and an idea. Your tests, questions and contributions can help shape what comes next. We would love to hear from you.
License
AriCodeOS is licensed under Apache-2.0: you can use, modify and redistribute it. In return, keep the NOTICE file and say that your work is “based on AriCodeOS by Edwin F. Veliz Jaramillo (lynxcraft)”.