Skip to content

Operations Guide

For operators running IOLake in production.

Installation

Planning and standing up a cluster — hardware sizing, Docker + Kubernetes deployment, topology design, and the full config reference.

  • Quickstart — simplest path from zero to a working gateway + meta + OSD stack
  • Docker — compose and per-service images
  • Topologies — failure-domain planning, EC layouts, single-node vs multi-node vs multi-zone
  • Configuration — every flag + TOML key, per service

Operations

Running the cluster day-to-day — metrics, alerts, incident response.

  • Monitoring — where metrics are, scraping aio vs helm, console views, Grafana dashboards, health endpoints
  • Metrics reference — every metric, its labels, and alerts worth setting
  • Failure Recovery — disk loss, OSD replacement, zone outage, meta quorum loss

Administration

API surface for managing a running cluster — users, access keys, policies, buckets, and the Iceberg catalog.