How-to guides

How-to guides solve a concrete goal. They assume you know the basics from the tutorials and give a direct, numbered procedure with no theory. When you want the why, read the explanation.

Snapshots

• Import from a directory
• Import from Git
• Import from a tar archive

Workspaces

• Fork a workspace
• Mount a workspace
• Checkpoint a workspace
• Diff and export
• Unmount a workspace

Deploy

• Install AWC
• Run locally
• Deploy on Proxmox VE
• Deploy on Kubernetes
• Deploy on a VM with systemd

Operate

• Upgrade a deployment
• Drain and restart a host
• Rotate credentials
• Run garbage collection
• Back up and restore PostgreSQL
• Handle disk pressure
• Handle a stale writer
• Handle object corruption
• Recover from a control-plane outage
• Recover from a PostgreSQL failover
• Recover from an object-store outage
• Recover from host loss
• Recover an interrupted checkpoint

Develop

• Build and package
• Run the test suite
• Contribute