Skip to content
Kernwall
Docs · preview

Install it with the network cable out.

How a site will install Kernwall OS on a box it already owns, from a USB stick to the first audited request, without the machine ever reaching the internet. This is the outline of the first release's install guide.

Before you start

What the install needs, and what it doesn't.

Everything happens inside your building. The only thing that crosses the gap is a signed file, the way your site already moves files.

You need
  • A Kernwall Desk-class box, or a server from the planned compatibility list
  • Removable media your site allows, or a one-way data diode
  • An import station: a workstation inside the wall that runs the offline verifier
  • Your directory (Active Directory or LDAP), so people sign in with the accounts they have
You don't need
  • An internet connection, during the install or at any point after it
  • A licence server, activation key or phone-home check
  • A cloud account of any kind

Choosing the box: three ways to get one, or size it for your users.

Install guide · outline

Six steps from USB stick to first request.

Each step shows the session an operator would see. Commands and output follow the first-release design; the exact flags may change before it ships.

Verify · step 1 of 6

Check the image inside the wall

Copy the release onto media and check it on the import station, not on the laptop that downloaded it. The signature is verified offline, then the installer is written out with your site's trust root on it.

What the import station checks

admin@import-01
$ kernwall import /media/usb/kernwall-community-2027.01.iso --sign-with site-key
tufroot v3 · time floor 2027-01-14 ✓
signatureML-DSA-87 + LMS · release key ✓
sbomSPDX + CycloneDX attached · 0 KEV reachable ✓
$ kernwall media write --to /dev/sdb
writteninstaller + site trust root ✓
Fig. 4Installing the Community ISO on your own box, step by step.

Architecture overview

Five layers and a loop on top.

What you just installed, top to bottom. Each layer has its spec table, sources and figures on the platform page; the threat model is on the trust page.

On top of the stack

Own Your Intelligence loop

Your evals and data are the asset. Base models are replaceable.

Layer details
Layer 05

Accreditation engine

Kernwall writes your evidence as it runs, not a consultant afterwards.

Layer details
Layer 04

Cross-gap delivery

One signed bundle carries OS, drivers, models and evidence across the gap.

Layer details
Layer 03

Model runtime

Pinned engines, cleared models and egress denied by default.

Layer details
Layer 02

Immutable OS

A read-only, image-based host with signed A/B updates and automatic rollback.

Layer details
Layer 01

Hardware root of trust

Your appliance proves what it booted before it unseals your data.

Layer details

Not published yet

What this page will link to.

Until these exist, a design-partner pilot is the way to run the install: on your hardware, inside your wall, with us on site.

  • The Community ISO and its detached signature
  • The full install and operations guide this page outlines
  • A signed changelog for each release
  • The public source repositories