Skip to main content

Platform Overview

Audience

This page is for maintainers, implementers, and operators entering the platform docs for the first time.

Goal and Scope

This page helps you quickly understand:
  1. what the formal AiOS runtime model is
  2. how platform responsibilities differ from application runtime responsibilities
  3. which architecture and environment pages to read next

Core Concepts

Runtime layering

AiOS uses:
  • a binary install/bootstrap entry
  • K3s + image-based services for formal runtime
  • stateless control-plane services with externalized state

Platform responsibilities

The platform is responsible for:
  • installation and cluster adoption
  • authorization, approval, audit, and task orchestration
  • application delivery policies and runtime governance
  • data-access gateways and security boundaries

Standard Workflow

  1. the installer detects the environment and initializes K3s
  2. platform dependencies and control-plane services are deployed into K3s
  3. users access the platform through Web / CLI / Agent channels using the same server-side capabilities

CLI Examples

go run ./cmd/aios
aios app up --env dev

Web UI Path

  • platform overview
  • cluster and environments
  • tasks and approvals
  • application delivery and deployment history

Pitfalls / Risk Notes

  • the local single-binary skeleton is only for bootstrap/dev validation
  • the formal runtime target remains image-based services inside K3s