Skip to main content

​
Single-Binary Installation

​
Audience

This page is for developers and operators who want to try the AiOS bootstrap entry or validate the local development flow.

​
Goal and Scope

This page explains how to start AiOS through the single-binary entry, with one important caveat:
  • this is the bootstrap / development-validation entry
  • it is not the final production runtime model

​
Core Concepts

  • the single binary starts the minimal control plane and install flow
  • the formal runtime target remains image-based services inside K3s

​
Standard Workflow

  1. prepare the local environment
  2. start cmd/aios
  3. verify startup with health checks
  4. continue into the bootstrap/install flow

​
CLI Examples

go run ./cmd/aios
curl http://localhost:8080/healthz
curl http://localhost:8080/readyz

​
Web UI Path

Once the service starts, the Web UI will serve as the bootstrap/install entry (to be expanded later).

​
Pitfalls / Risk Notes

  • local single-binary startup is only for development and bootstrap, not the formal production shape
  • formal runtime should later deploy the control-plane services into K3s