StellOS

StellOS is a Rust-first minimal enterprise operating system project for the Stell ecosystem. Its long-term positioning is a Debian-like operating system distribution: stable, secure, reproducible, package-oriented, and suitable for infrastructure, cloud-native platforms, and middleware workloads.

Positioning

StellOS is not a general-purpose desktop experiment. It is designed as an enterprise minimal operating system foundation with a small trusted base, deterministic packaging, service lifecycle management, and clear operational contracts.

The project starts with Rust system components and a minimal kernel/runtime architecture. Over time it can grow into a full distribution with package repositories, release channels, installer images, observability, and enterprise support policy.

Goals

• Provide a Rust-first operating system foundation with a minimal trusted computing base.
• Support Debian-like distribution concepts: packages, repositories, release channels, upgrade policy, and long-term maintenance.
• Keep infrastructure workloads first: middleware, service governance, observability, storage, networking, and control-plane components.
• Make builds reproducible and auditable.
• Provide secure defaults for boot, identity, service lifecycle, and package provenance.
• Keep the core small enough to reason about, test, and harden.

Non-Goals

• It is not a desktop distribution.
• It is not a Linux distribution fork at this stage.
• It is not production-ready yet.
• It does not promise ABI or package compatibility before the first stable release.

Current Status

Item	Value
Stability	Early architecture skeleton
Primary language	Rust
Project type	Minimal enterprise operating system / distribution foundation
Target users	Platform engineers, infrastructure teams, middleware operators
Maintainer	StellHub

Workspace Layout

.
├── crates/
│   ├── stellos-core/      # Distribution metadata, package, and service model
│   └── stellos-kernel/    # Minimal kernel/runtime bootstrap skeleton
├── docs/
│   └── architecture.md    # Architecture notes and roadmap
├── Cargo.toml
└── README.md

Architecture

flowchart TB
    Kernel["StellOS Kernel Runtime"]
    Core["StellOS Core Model"]
    Packages["Package Repository"]
    Services["Service Lifecycle"]
    Security["Secure Boot and Provenance"]
    Operations["Observability and Operations"]

    Kernel --> Core
    Core --> Packages
    Core --> Services
    Core --> Security
    Core --> Operations

Loading

Crates

Crate	Responsibility
stellos-core	Release metadata, package declarations, service manifests, and enterprise policy primitives
stellos-kernel	Minimal kernel/runtime bootstrap model and early boot state

Roadmap

• Define the stable release metadata model.
• Add package manifest validation and repository index format.
• Add service lifecycle manifest model.
• Add boot image and target architecture planning.
• Add package provenance and signature verification design.
• Add installer and upgrade strategy.
• Add enterprise release channels: dev, uat, pre, prod, and lts.

Development

After installing the Rust toolchain, run:

cargo test --workspace

License

The license will be defined before the first stable release.