Argonaut v0.1.0
The first public release of Argonaut — a keyboard-driven Terminal UI for Ceph.
Stop memorizing long ceph commands: browse your cluster, inspect resources, and perform common operational tasks through a fast, transparent terminal interface. Every action previews the exact ceph command it runs, and destructive changes always require confirmation.
Features
- Dashboard — health (with full
ceph health detail), capacity, client IO and recovery, refreshed live. - OSDs — mark in/out, reweight, destroy/purge/remove, metadata and utilisation.
- Pools — create, edit (size/min_size/PG/autoscale/rule), delete.
- CRUSH — interactive hierarchy tree; move buckets, view rules.
- Cluster flags — view/toggle with descriptions, rationale and risks.
- Services — cephadm services and daemons; restart, start, stop.
- Placement groups — cluster-wide listing, live filter, scrub / deep-scrub / repair.
- Consistent UX —
/filters any table,:command prompt, andy/nconfirmations that always preview the equivalentcephcommand.
Supported platforms
- Linux
amd64— prebuilt binary attached below. - Ceph Reef (18), Squid (19), Tentacle (20) — validated against real clusters (build/link CI plus per-release JSON decode fixtures).
Install
Install the Ceph client runtime libraries, then download the binary:
# Debian/Ubuntu: sudo apt-get install -y librados2 librbd1
# RHEL/Rocky/Alma: sudo dnf install -y librados2 librbd1
VERSION=v0.1.0
BASE="https://github.com/cinpol/argonaut/releases/download/$VERSION"
curl -LO "$BASE/argonaut_${VERSION#v}_linux_amd64.tar.gz"
curl -LO "$BASE/checksums.txt"
sha256sum --ignore-missing -c checksums.txt
tar xzf "argonaut_${VERSION#v}_linux_amd64.tar.gz"
sudo install -m 0755 argonaut /usr/local/bin/argonaut
sudo argonautSee the README for build-from-source and full requirements.
Known limitations
- Linux amd64 only for now — arm64 and package channels (Homebrew, deb/rpm) are planned for later releases. Other platforms build from source.
- Argonaut runs with the privileges of the operator and the Ceph keyring it is given, and performs cluster-mutating operations — treat it like the ceph CLI.
License
Apache-2.0. Argonaut dynamically links the Ceph client libraries (librados/librbd, LGPL-2.1) when built with the goceph tag. See NOTICE for third-party attribution.