Skip to main content

Bootstrap: Light Mode

Audience

This page is for developers and implementers who want a lighter AiOS bootstrap path.

Goal and Scope

This page explains the light-mode install flow and how it differs from full mode.

Core Concepts

  • light mode still installs or adopts K3s
  • the difference is a lighter dependency footprint and faster bootstrap defaults
  • the formal runtime target still remains image-based services inside K3s

Standard Workflow

  1. run preflight checks
  2. detect the network and select sources
  3. install or adopt K3s
  4. deploy the minimal dependencies and control plane
  5. initialize default environments

CLI Examples

go run ./cmd/aios

Web UI Path

Choose light mode in the install wizard and continue through the bootstrap flow.

Pitfalls / Risk Notes

  • light mode does not bypass the clustered runtime model; it only makes bootstrap lighter
  • if you later need fuller platform capabilities, you should expand toward the full-mode capability set