Asterinas is a secure, fast, and general-purpose OS kernel, written in Rust and providing Linux-compatible ABI.
Go to file
Tate, Hongliang Tian 2266ce5959 Add a disclaimer to clarify the relationship with NixOS foundation 2025-12-17 13:52:34 +08:00
.github Define `ASTER_SCML` in `validate_scmls` workflow 2025-12-14 08:08:56 +08:00
.vscode Use rust-analyzer for riscv64 and loongarch64 target 2025-08-29 16:57:06 +08:00
book Add a disclaimer to clarify the relationship with NixOS foundation 2025-12-17 13:52:34 +08:00
distro Make configuration.nix in ISO editable 2025-12-13 13:18:08 +08:00
kernel Clarify the code for a long shebang 2025-12-15 10:12:12 +08:00
osdk Bump the project version to 0.17.0 2025-12-14 00:08:33 +08:00
ostd Bump the project version to 0.17.0 2025-12-14 00:08:33 +08:00
test Define `__asterinas__` macro in tests 2025-12-16 12:03:43 +08:00
tools Bump the project version to 0.17.0 2025-12-14 00:08:33 +08:00
.code-workspace
.dockerignore
.gitignore Add cachix binary cache 2025-12-12 00:19:00 +08:00
.licenserc.yaml
.typos.toml Fix some typos 2025-11-28 19:10:16 +08:00
CODEOWNERS Rename `syscall-feature-coverage` to `syscall-flag-coverage` 2025-12-04 12:51:45 +08:00
COPYRIGHT
Cargo.lock Bump the project version to 0.17.0 2025-12-14 00:08:33 +08:00
Cargo.toml Add `i8042.exist` to override ACPI flags 2025-12-07 09:52:42 +08:00
Components.toml Add `i8042.exist` to override ACPI flags 2025-12-07 09:52:42 +08:00
DOCKER_IMAGE_VERSION Bump the docker version to 0.17.0 2025-12-13 21:41:04 +08:00
LICENSE-MPL
Makefile Add `BASIC_TEST_PLATFORM` option 2025-12-16 12:03:43 +08:00
OSDK.toml Fix missing virtio-blk-device configuration for riscv64 2025-11-20 10:43:24 +08:00
README.md Add a disclaimer to clarify the relationship with NixOS foundation 2025-12-17 13:52:34 +08:00
RELEASES.md Add the release notes for version 0.16.0 2025-08-05 09:11:17 +08:00
VERSION Bump the project version to 0.17.0 2025-12-14 00:08:33 +08:00
rust-toolchain.toml Upgrade the Rust toolchain to 20251208 2025-12-09 09:23:58 +08:00
rustfmt.toml Implement new ioctl infrastructure 2025-12-07 12:01:05 +08:00
triagebot.toml

README.md

asterinas-logo
A secure, fast, and general-purpose OS kernel written in Rust and compatible with Linux

https://github.com/user-attachments/assets/26be2d18-994d-4658-a1b8-f8959bd88b75

Test x86-64 Test riscv64 Test loongarch64 Test Intel TDX Benchmark x86-64 Benchmark Intel TDX

News:

Congratulations to the Asterinas community🎉🎉🎉

Introducing Asterinas

Asterinas is a secure, fast, and general-purpose OS kernel that provides Linux-compatible ABI. It can serve as a seamless replacement for Linux while enhancing memory safety and developer friendliness.

  • Asterinas prioritizes memory safety by employing Rust as its sole programming language and limiting the use of unsafe Rust to a clearly defined and minimal Trusted Computing Base (TCB). This innovative approach, known as the framekernel architecture, establishes Asterinas as a more secure and dependable kernel option.

  • Asterinas surpasses Linux in terms of developer friendliness. It empowers kernel developers to (1) utilize the more productive Rust programming language, (2) leverage a purpose-built toolkit called OSDK to streamline their workflows, and (3) choose between releasing their kernel modules as open source or keeping them proprietary, thanks to the flexibility offered by MPL.

While the journey towards a production-grade OS kernel is challenging, we are steadfastly progressing towards this goal. Over the course of 2024, we significantly enhanced Asterinas's maturity, as detailed in our end-year report. In December 2025, we launched Asterinas NixOS, an Asterinas distribution based on NixOS. This release marks Asterinas reaching the Minimum Viable Product (MVP) milestone. In 2026, we aim to make Asterinas production-ready on x86-64 virtual machines and attract real users.

Getting Started

For End Users

We provide Asterinas NixOS ISO Installer to make the Asterinas kernel more accessible for early adopters and enthusiasts. We encourage you to try out Asterinas NixOS and share feedback. Instructions on how to use the ISO installer can be found here.

Disclaimer: Asterinas is an independent, community-led project. Asterinas NixOS is not an official NixOS project and has no affiliation with the NixOS Foundation. No sponsorship or endorsement is implied.

For Kernel Developers

Follow the steps below to get Asterinas up and running.

  1. Download the latest source code on an x86-64 Linux machine:

    git clone https://github.com/asterinas/asterinas
    
  2. Run a Docker container as the development environment:

    docker run -it --privileged --network=host -v /dev:/dev -v $(pwd)/asterinas:/root/asterinas asterinas/asterinas:0.17.0-20251213
    
  3. Inside the container, go to the project folder (/root/asterinas) and run:

    make kernel
    make run_kernel
    

    This results in a VM running the Asterinas kernel with a small initramfs.

  4. To install and test real-world applications on Asterinas, build and run Asterinas NixOS in a VM:

    make nixos
    make run_nixos
    

    This boots into an interactive shell in Asterinas NixOS, where you can use Nix to install and try more packages.

The Book

See The Asterinas Book to learn more about the project.

License

Asterinas's source code and documentation primarily use the Mozilla Public License (MPL), Version 2.0. Select components are under more permissive licenses, detailed here. For the rationales behind the choice of MPL, see here.