# NØNOS Operating System

***

### What is NØNOS?

**NØNOS** is a zero-trust, quantum-resistant operating system built from the ground up in Rust. Unlike traditional operating systems that rely on software trust boundaries, NØNOS implements **cryptographic verification at every layer** from the moment your hardware powers on to every instruction that executes.

{% embed url="<https://www.youtube.com/watch?v=3Ry_MZIF1X0>" %}

#### The Problem with Traditional Operating Systems

| Traditional OS                    | NØNOS                                           |
| --------------------------------- | ----------------------------------------------- |
| Trust the bootloader blindly      | Cryptographically verify bootloader             |
| Kernel loads without verification | Ed25519 signature verification before execution |
| Software-based access control     | Hardware-enforced capability tokens             |
| Vulnerable to quantum attacks     | Post-quantum cryptography (ML-KEM, ML-DSA)      |
| Large kernel (\~5MB+ compressed)  | Minimal kernel (\~221KB stripped)               |
| Opaque execution                  | Zero-knowledge attestation                      |

***

#### Core Philosophy

NØNOS is built on three foundational principles:

1. **Zero Trust;** No component trusts another without cryptographic proof. The bootloader verifies the kernel. The kernel verifies modules. Every boundary requires authentication.
2. **Minimal Attack Surface;** The kernel is \~221KB stripped. Less code means fewer vulnerabilities. Every line is auditable.
3. **Quantum Readiness;** Classical cryptography will be broken by quantum computers. NØNOS implements NIST-standardized post-quantum algorithms today.

***

### Architecture Overview

```
┌─────────────────────────────────────────────────────────────────┐
│                     USER APPLICATIONS                           │
│  ┌──────────────┐  ┌──────────────┐  ┌────────────────────────┐ │
│  │   Desktop    │  │   Terminal   │  │   Network Services     │ │
│  └──────────────┘  └──────────────┘  └────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      CAPABILITY LAYER                           │
│  ┌──────────────┐  ┌──────────────┐  ┌────────────────────────┐ │
│  │ Token Verify │  │  Permission  │  │   Resource Binding     │ │
│  └──────────────┘  └──────────────┘  └────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    NONOS KERNEL (~221KB)                        │
│  ┌──────────────┐  ┌──────────────┐  ┌────────────────────────┐ │
│  │   Scheduler  │  │    Memory    │  │   Crypto Primitives    │ │
│  │              │  │  Management  │  │  Ed25519 | BLAKE3      │ │
│  │              │  │              │  │  ML-KEM | AES-GCM      │ │
│  └──────────────┘  └──────────────┘  └────────────────────────┘ │
│  ┌──────────────┐  ┌──────────────┐  ┌────────────────────────┐ │
│  │   Drivers    │  │  Filesystem  │  │     ZK Engine          │ │
│  │  PCI | GPU   │  │  VFS | Crypt │  │  Groth16 | Halo2       │ │
│  └──────────────┘  └──────────────┘  └────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                  UEFI BOOTLOADER (~300KB)                       │
│  ┌──────────────┐  ┌──────────────┐  ┌────────────────────────┐ │
│  │  Ed25519     │  │   BLAKE3     │  │    Groth16 ZK          │ │
│  │  Signature   │  │   Hashing    │  │    Verification        │ │
│  │  Verify      │  │              │  │    (Optional)          │ │
│  └──────────────┘  └──────────────┘  └────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     UEFI FIRMWARE                               │
│           Hardware Root of Trust (Secure Boot)                  │
└─────────────────────────────────────────────────────────────────┘
```

***

### Key Features

#### Cryptographic Boot Chain

Every boot is verified:

1. **UEFI Secure Boot** verifies the NØNOS bootloader
2. **Bootloader** computes BLAKE3 hash of kernel
3. **Ed25519 signature** verified against embedded public keys
4. **Optional ZK proof** for privacy-preserving attestation
5. **Only then** does the kernel execute

***

#### Post-Quantum Cryptography

NØNOS implements NIST FIPS 203/204 standards:

| Algorithm   | Purpose            | Security Level                    |
| ----------- | ------------------ | --------------------------------- |
| ML-KEM-768  | Key encapsulation  | NIST Level 3 (AES-192 equivalent) |
| ML-DSA-65   | Digital signatures | NIST Level 3                      |
| Ed25519     | Fast signatures    | 128-bit classical                 |
| BLAKE3      | Hashing            | 256-bit                           |
| AES-256-GCM | Encryption         | 256-bit                           |

#### Capability-Based Security

Access control through unforgeable tokens:

```
┌────────────────────────────────┐
│      Capability Token          │
├────────────────────────────────┤
│  Resource ID    │ unique ref   │
│  Permissions    │ READ|WRITE   │
│  Expiry         │ optional TTL │
│  Crypto Tag     │ HMAC proof   │
└────────────────────────────────┘
```

No token = no access. Tokens cannot be forged or escalated.

***

#### Zero-Knowledge Proofs

Prove statements without revealing secrets:

* **Boot attestation;** Prove kernel is valid without revealing internals
* **Anonymous auth;** Prove membership without revealing identity
* **Privacy credentials;** Verify attributes without exposing data

***

### Technical Specifications

| Component        | Specification                         |
| ---------------- | ------------------------------------- |
| **Architecture** | x86\_64 (ARM64 planned)               |
| **Language**     | Rust (no\_std, zero unsafe in crypto) |
| **Bootloader**   | \~300KB (UEFI)                        |
| **Kernel**       | \~221KB (stripped)                    |
| **ISO Image**    | \~65MB                                |

***

### Quick Start

```bash
# Clone both repositories
git clone https://github.com/NON-OS/nonos-kernel.git
git clone https://github.com/NON-OS/nonos-boot.git

***POSSIBILY A MONOREPO SOON at https://github.com/NON-OS/nonos-kernel***

# Build kernel
cd nonos-kernel
make

# Run in QEMU
make run
```

See Quick Start Guide for detailed instructions.

***

### Development Status

NØNOS is under **active development**. Current implementation status:

| Component         | Status                | Notes                                    |
| ----------------- | --------------------- | ---------------------------------------- |
| UEFI Bootloader   | Complete              | Ed25519 verification, BLAKE3 hashing     |
| Kernel Core       | Complete              | Scheduler, memory management, interrupts |
| Cryptography      | Complete (Test phase) | Ed25519, BLAKE3, AES-GCM, ML-KEM         |
| Capability System | Complete              | Token generation and verification        |
| ZK Engine         | Partially completed   | Groth16 verification                     |
| Desktop/UI        | Complete              | Basic window management                  |
| Network Stack     | In Progress           | IPv4, IPv6, TCP (smoltcp)                |
| Filesystem        | In Progress           | VFS, encrypted storage                   |
| ARM64 Support     | Planned               | —                                        |

***

### Official Links

| Resource       | Link                                                         |
| -------------- | ------------------------------------------------------------ |
| **Whitepaper** | [nonos.systems/whitepaper](https://nonos.systems/whitepaper) |
| **Website**    | [nonos.systems](https://nonos.systems)                       |
| **GitHub**     | [github.com/NON-OS](https://github.com/NON-OS)               |

***

### License

NØNOS is released under **AGPL-3.0**.

***

### Documentation Sections

<table data-view="cards"><thead><tr><th></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Getting Started</strong></td><td>Build and run NØNOS in 5 minutes</td><td><a href="https://docs.nonos.systems/~/revisions/4Rs9Gk1Qn6FOI1OjRtBd/getting-started-os">https://docs.nonos.systems/~/revisions/4Rs9Gk1Qn6FOI1OjRtBd/getting-started-os</a></td><td></td><td><a href="https://3552540895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHcGoi6yLMUd8PrdEa0au%2Fuploads%2FjS6XTquypNJMzzzefcfR%2Fphoto_2025-12-18%201.59.36%E2%80%AFAM.jpeg?alt=media&#x26;token=084fec33-203d-4ee5-a712-d42389c1dd5e">photo_2025-12-18 1.59.36 AM.jpeg</a></td></tr><tr><td><strong>Architecture</strong></td><td>Deep dive into system design</td><td></td><td></td><td><a href="https://3552540895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHcGoi6yLMUd8PrdEa0au%2Fuploads%2FVAg4tD8LytY6RO99Acc5%2Fphoto_2025-12-18%2012.12.26%E2%80%AFPM.jpeg?alt=media&#x26;token=b39a83e0-d357-467d-b8be-12b911df3e66">photo_2025-12-18 12.12.26 PM.jpeg</a></td></tr><tr><td><strong>Cryptography</strong></td><td>Signing, encryption, post-quantum</td><td></td><td></td><td><a href="https://3552540895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHcGoi6yLMUd8PrdEa0au%2Fuploads%2F3RJp97G6wqQODhMTw2Xm%2Fphoto_2025-12-18%202.41.17%E2%80%AFAM.jpeg?alt=media&#x26;token=33be9629-981e-44c7-80cc-30b55d7903a8">photo_2025-12-18 2.41.17 AM.jpeg</a></td></tr><tr><td><strong>Zero-Knowledge</strong></td><td>ZK circuits and verification</td><td></td><td></td><td><a href="https://3552540895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHcGoi6yLMUd8PrdEa0au%2Fuploads%2FmdhLAoUE4witvXyTTTTn%2Fphoto_2025-12-18%205.51.38%E2%80%AFAM.jpeg?alt=media&#x26;token=5f544ec4-29df-4ea1-bd49-0759aef6f171">photo_2025-12-18 5.51.38 AM.jpeg</a></td></tr><tr><td><strong>Building</strong></td><td>Complete build documentation</td><td><a href="https://docs.nonos.systems/~/revisions/4Rs9Gk1Qn6FOI1OjRtBd/building-nonos-os">https://docs.nonos.systems/~/revisions/4Rs9Gk1Qn6FOI1OjRtBd/building-nonos-os</a></td><td></td><td><a href="https://3552540895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHcGoi6yLMUd8PrdEa0au%2Fuploads%2FDc59ts3uvVS3j8YD3Y9o%2Fphoto_2025-12-18%2012.12.40%E2%80%AFPM.jpeg?alt=media&#x26;token=82d5f542-358d-432d-8a63-31b6ac13e4d0">photo_2025-12-18 12.12.40 PM.jpeg</a></td></tr><tr><td><strong>Contributing</strong></td><td>Join the development</td><td></td><td></td><td><a href="https://3552540895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHcGoi6yLMUd8PrdEa0au%2Fuploads%2FOAuZcTAYbsHmUghLaZuw%2Fphoto_2025-12-18%205.51.25%E2%80%AFAM.jpeg?alt=media&#x26;token=bb2d6e80-7b63-4899-bf53-2c42f611dd5e">photo_2025-12-18 5.51.25 AM.jpeg</a></td></tr></tbody></table>
