Asterinas is a secure, fast, and general-purpose OS kernel, written in Rust and providing Linux-compatible ABI.
Go to file
Wei Zhang 8df2129c39 xfdesktop4: Use consistent monitor identifiers for wallpaper
The settings dialog used gdk_monitor_get_model() which often returns
NULL, generating invalid property paths. The main daemon uses
xfw_monitor_get_connector(), causing a mismatch that prevented wallpaper
changes.

Fix by using GDK APIs to obtain a valid monitor model name, aligning
with the daemon's identification logic.
2025-12-12 16:23:30 +08:00
.github Add more podman commands test in CI 2025-12-12 14:41:16 +08:00
.vscode
book Switch to a new Docker image 0.16.2-20251211 2025-12-12 00:15:57 +08:00
distro xfdesktop4: Use consistent monitor identifiers for wallpaper 2025-12-12 16:23:30 +08:00
kernel Fix the implementation of prlimit64 syscall and the init process value of ResourceLimits 2025-12-11 18:01:20 +08:00
osdk Extract the crate name from the path argument of `cargo osdk new` 2025-12-12 00:19:32 +08:00
ostd Invalidate cache when remapping interrupts 2025-12-11 15:29:15 +08:00
test Add ISO installer image 2025-12-11 22:07:24 +08:00
tools Add cachix binary cache 2025-12-12 00:19:00 +08:00
.code-workspace
.dockerignore
.gitignore Add cachix binary cache 2025-12-12 00:19:00 +08:00
.licenserc.yaml
.typos.toml
CODEOWNERS
COPYRIGHT
Cargo.lock Bump version to 0.16.2 2025-12-09 19:41:18 +08:00
Cargo.toml
Components.toml
DOCKER_IMAGE_VERSION Bumped Docker image version to 0.16.2-20251211 2025-12-11 20:34:02 +08:00
LICENSE-MPL
Makefile Add cachix binary cache 2025-12-12 00:19:00 +08:00
OSDK.toml
README.md Switch to a new Docker image 0.16.2-20251211 2025-12-12 00:15:57 +08:00
README_CN.md Switch to a new Docker image 0.16.2-20251211 2025-12-12 00:15:57 +08:00
README_JP.md Switch to a new Docker image 0.16.2-20251211 2025-12-12 00:15:57 +08:00
RELEASES.md
VERSION Bump version to 0.16.2 2025-12-09 19:41:18 +08:00
rust-toolchain.toml
rustfmt.toml
triagebot.toml

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 loongarch64 Test Intel TDX Benchmark x86-64 Benchmark Intel TDX

English | 中文版 | 日本語

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. By the end of 2025, we plan to launch Asterinas NixOS, the first distribution for Asterinas. This release will mark 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

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 -v /dev:/dev -v $(pwd)/asterinas:/root/asterinas asterinas/asterinas:0.16.2-20251211
  1. Inside the container, go to the project folder to build and run Asterinas.
make kernel
make run_kernel

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.