Asterinas is a secure, fast, and general-purpose OS kernel, written in Rust and providing Linux-compatible ABI.
Go to file
Ruihan Li 5ccadb6253 Support SOCK_SEQPACKET 2025-07-23 20:02:15 +08:00
.github Apply the docker version bump for related files 2025-07-17 20:58:27 +08:00
.vscode Fix all spelling mistakes in history by typos tool 2024-08-27 12:19:48 +08:00
docs Add sys_ioprio_set and sys_ioprio_get 2025-07-22 17:22:52 +08:00
kernel Support SOCK_SEQPACKET 2025-07-23 20:02:15 +08:00
osdk Use official minicov and add unit test for coverage feature 2025-07-22 10:31:56 +08:00
ostd adjust feature enabling sequence and fix xsave size function 2025-07-22 17:15:53 +08:00
test Support SOCK_SEQPACKET 2025-07-23 20:02:15 +08:00
tools Use default process name in TDX QEMU configuration 2025-07-10 10:13:51 +08:00
.code-workspace Enable the rust-analyzer for OSDK 2024-04-25 09:44:46 +08:00
.dockerignore Rename regression to test 2024-06-28 20:33:21 +08:00
.gitignore Let git ignore profile results 2025-02-13 16:01:40 +08:00
.licenserc.yaml Remove local tdx-guest crate 2024-04-29 10:13:04 +08:00
.typos.toml Restructure the test directory 2025-07-04 18:52:26 +08:00
CODEOWNERS Reassign test code owner 2025-07-04 18:52:26 +08:00
COPYRIGHT Update the license to MPLv2 2023-12-26 17:43:45 +08:00
Cargo.lock Add release support for keyboard 2025-07-22 15:16:12 +08:00
Cargo.toml Add basic i8042 keyboard support 2025-06-27 12:56:55 +08:00
Components.toml Add basic i8042 keyboard support 2025-06-27 12:56:55 +08:00
DOCKER_IMAGE_VERSION Add LoongArch QEMU to the docker image and bump versions 2025-07-16 21:57:25 +08:00
LICENSE-MPL Update the license to MPLv2 2023-12-26 17:43:45 +08:00
Makefile Add coverage support 2025-07-22 10:31:56 +08:00
OSDK.toml Specify ktest osdk args in Makefile 2025-06-18 16:13:52 +08:00
README.md Update README.md for SOSP'25 news 2025-07-23 19:23:55 +08:00
README_CN.md Apply the docker version bump for related files 2025-07-17 20:58:27 +08:00
README_JP.md Apply the docker version bump for related files 2025-07-17 20:58:27 +08:00
VERSION Bump version to 0.15.2 2025-06-26 08:16:22 +08:00
rust-toolchain.toml Upgrade the toolchain to nightly-2025-02-01 2025-02-27 09:05:03 +08:00
rustfmt.toml Add rustfmt.toml configuration to adjust the format of imports 2024-02-26 10:03:45 +08:00
triagebot.toml Manage S-waiting-on-author and S-waiting-on-review automatically 2024-10-24 19:12:04 +08:00

README.md

asterinas-logo
A secure, fast, and general-purpose OS kernel written in Rust and compatible with Linux
Test x86-64 Test riscv64 Test Intel TDX Benchmark x86-64

English | 中文版 | 日本語

NEWS: SOSP'25 accepted yet another research paper on Asterinas: CortenMM: Efficient Memory Management with Strong Correctness Guarantees. Congratulations to the Asterinas community🎉🎉🎉

NEWS: USENIX ATC'25 accepted two research papers on Asterinas: (1) Asterinas: A Linux ABI-Compatible, Rust-Based Framekernel OS with a Small and Sound TCB and (2) Converos: Practical Model Checking for Verifying Rust OS Kernel Concurrency. 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 2025, our primary goal is to make Asterinas production-ready on x86-64 virtual machines and attract real users!

Getting Started

Get yourself an x86-64 Linux machine with Docker installed. Follow the three simple steps below to get Asterinas up and running.

  1. Download the latest source code.
git clone https://github.com/asterinas/asterinas
  1. Run a Docker container as the development environment.
docker run -it --privileged --network=host --device=/dev/kvm -v $(pwd)/asterinas:/root/asterinas asterinas/asterinas:0.15.2-20250714
  1. Inside the container, go to the project folder to build and run Asterinas.
make build
make run

If everything goes well, Asterinas is now up and running inside a VM.

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.