Skip to content

Commit a58bb3b

Browse files
authored
added links in the tech overview (#475)
1 parent 699c2e0 commit a58bb3b

1 file changed

Lines changed: 12 additions & 3 deletions

File tree

technical-overview.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,24 +10,26 @@ And because Edera doesn’t rely on nested virtualization, it runs wherever cont
1010

1111
## How Edera Works
1212

13-
At its core, Edera uses a custom hypervisor based on Xen, with key components rewritten in Rust for safety, performance, and maintainability. Edera introduces the concept of **zones**—independent, fast-booting virtual machines that serve as security boundaries for container workloads.
13+
At its core, Edera uses a [custom hypervisor](https://edera.dev/stories/rust-or-bust-our-rewrite-of-the-xen-control-plane) based on [Xen](https://edera.dev/stories/why-edera-built-on-xen-a-secure-container-foundation), with key components rewritten in Rust for safety, performance, and maintainability. Edera introduces the concept of **zones**—independent, fast-booting virtual machines that serve as security boundaries for container workloads.
1414

1515
Each zone runs its own Linux kernel and minimal init system. The kernel and other system components are delivered via OCI images, keeping things composable, cacheable, and consistent.
1616

17-
Zones are paravirtualized using the Xen PV protocol. This keeps them lightweight and fast—no hardware virtualization required. But when hardware support is available (e.g., on x86 with VT-x), Edera uses it to get near bare-metal performance.
17+
Zones are [paravirtualized](https://docs.edera.dev/concepts/paravirtualization/) using the Xen PV protocol. This keeps them lightweight and fast—no hardware virtualization required. But when hardware support is available (e.g., on x86 with VT-x), Edera uses it to get near bare-metal performance.
1818

1919
## How Edera Runs & Secures Containers
2020

2121
Edera allows you to compose your infrastructure the same way you compose workloads: using OCI images.
2222

2323
Each zone consumes a small number of OCI images:
24+
2425
- A **kernel image** that provides the zone kernel.
2526
- One or more **system extension images** that provide init systems, utilities, and kernel modules.
2627
- Optionally, **driver zones**—zones that provide shared services (like networking) to other zones.
2728

28-
Inside each zone, container workloads run via a minimal OCI runtime called **Styrolite**, written in Rust. Unlike traditional setups (like Kata Containers, which layer containerd and runc as external processes), Styrolite is embedded inside the zone itself.
29+
Inside each zone, container workloads run via a minimal OCI runtime called [**Styrolite**]((https://github.com/edera-dev/styrolite/)), written in Rust. Unlike traditional setups (like Kata Containers, which layer containerd and runc as external processes), Styrolite is embedded inside the zone itself.
2930

3031
### Key Benefits of This Design
32+
3133
- No external container runtime processes
3234
- Zone init system directly manages containers
3335
- Minimal attack surface, optimized for secure execution
@@ -68,19 +70,26 @@ This causes the pod to be scheduled to a node running Edera’s hypervisor. The
6870
An Edera zone is a minimal VM built from OCI-delivered components. At launch time, the Edera daemon unpacks:
6971
7072
### Kernel Image
73+
7174
Located under `/kernel` in the OCI image:
75+
7276
- `image`: the Linux kernel (vmlinuz)
7377
- `metadata`: key-value pairs for boot parameters
7478
- `addons.squashfs`: includes kernel modules in `/modules`
7579
- `config.gz`: the kernel configuration file
7680

7781
### Initramfs Contents
82+
7883
Packaged in a CPIO archive, typically mounted from:
7984
`usr/lib/edera/protect/zone/initrd`
8085

8186
The initramfs includes:
87+
8288
- `/init`: static Rust binary that initializes the zone
8389
- `/bin/styrolite`: embedded container runtime
8490
- `/bin/zone`: control plane for managing containers and services via IDM (inter-domain messaging)
8591

8692
This structure lets Edera launch zones rapidly, with well-defined boundaries and no dependency on the host OS kernel. Everything the workload touches is defined, versioned, and validated.
93+
94+
---
95+
If you want to know more check out our [docs site](https://docs.edera.dev)

0 commit comments

Comments
 (0)