Skip to main content

Backup Model

Audience

This page is for operators and maintainers responsible for recovery, data protection, and disaster-readiness planning.

Goal and Scope

This page explains what must be backed up in AiOS and how recovery should work with an externalized-state control plane.

Core Concepts

Primary state store

The following must use PostgreSQL as the authoritative source:
  • task state and task steps
  • approval tickets and consumption state
  • audit events
  • installer step events
  • deployment records and revisions

Object storage

The following belong in MinIO/S3-style object storage:
  • archived install logs
  • import reports and exported artifacts
  • approval attachments
  • runtime artifacts and supplemental logs

Standard Workflow

  1. back up critical PostgreSQL tables regularly
  2. apply lifecycle and replication policy to key object-storage paths
  3. restore external state first, then restore control-plane service replicas