cephadm

Bootstrap a new Ceph cluster

$ sudo cephadm bootstrap --mon-ip [monitor_ip]

$ sudo cephadm add-host [hostname] [ip_address]

$ sudo cephadm deploy [service_type] --name [service_name]

$ sudo cephadm shell -- ceph -s

$ sudo cephadm shell

$ sudo cephadm rm-service [service_type] --name [service_name]

cephadm [options] command [arguments]

cephadm deploys and manages Ceph distributed storage clusters using containers (Podman preferred, Docker supported). It is the modern orchestration tool for Ceph, replacing older deployment methods like ceph-deploy and ceph-ansible.
The tool handles the complete cluster lifecycle: bootstrapping a new cluster on a single node, adding hosts, deploying daemons (monitors, OSDs, managers, gateways), and upgrading the cluster. Each Ceph daemon runs in its own container, providing isolation and simplified upgrades.
The `bootstrap` command creates an initial single-node cluster with a monitor and manager, generates admin credentials, and sets up the orchestrator for subsequent operations. The `shell` command provides an interactive environment inside a Ceph container with all management tools available.

--mon-ip ip

Monitor IP address for bootstrap

Service or daemon name

Container image to use

bootstrap

Initialize a new Ceph cluster

Add a host to the cluster

Remove a host from the cluster

Deploy a daemon

Remove a daemon

Enter interactive shell in Ceph container

View daemon logs

Requires container runtime (Podman preferred, Docker supported). Bootstrap creates initial admin credentials. Services are managed through the orchestrator, not directly.

ceph(8), podman(1)