Install Ceph on Ubuntu | Ubuntu

Your submission was sent successfully! Close
Thank you for contacting us. A member of our team will be in touch shortly. Close
You have successfully unsubscribed! Close
Thank you for signing up for our newsletter! In these regular emails you will find the latest updates about Ubuntu and upcoming events where you can meet our team.Close
Your preferences have been successfully updated. Close notification
Please try again or file a bug report. Close
Ceph is a storage system designed for excellent performance, reliability, and scalability. However, the installation and management of Ceph can be challenging. The Ceph-on-Ubuntu solution takes the administration minutiae out of the equation through the use of snaps and Juju charms. With either approach, the deployment of a Ceph cluster becomes trivial as does the scaling of the cluster's storage capacity.
Looking for help running Ceph?
These installation instructions use MicroCeph - Ceph in a snap. MicroCeph is a pure upstream Ceph distribution designed for small scale and edge deployments, which can be installed and maintained with minimal knowledge and effort.
You will need a multi-core processor and at least 8GiB of memory and 100GB of disk space. MicroCeph has been tested on x86-based physical and virtual machines running Ubuntu 22.04 LTS.
To get started, install the MicroCeph snap with the following command on each node to be used in the cluster:
Then bootstrap the cluster:
Check the cluster status with the following command:
Here you should see that there is a single node in the cluster.
To use MicroCeph as a single node, the default CRUSH rules need to be modified:
Next, add some disks that will be used as OSDs:
Repeat for each disk you would like to use as an OSD on that node, and additionally on the other nodes in the cluster. Cluster status can be verified using:
These installation instructions use MicroCeph – Ceph in a snap. MicroCeph is a pure upstream Ceph distribution designed for small scale and edge deployments, which can be installed and maintained with minimal knowledge and effort.
You will need 4 physical machines with multi-core processors and at least 8GiB of memory and 100GB of disk space. MicroCeph has been tested on x86-based physical machines running Ubuntu 22.04 LTS.
To get started, install the MicroCeph snap with the following command on each node to be used in the cluster:
Then bootstrap the cluster from the first node:
On the first node, add other nodes to the cluster:
Copy the resulting output to be used on node[x]:
Repeat these steps for each additional node you would like to add to the cluster.
Check the cluster status with the following command:
Here you should see that all the nodes you added have joined the cluster, in the familiar ceph status output.
Next, add some disks to each node that will be used as OSDs:
Repeat for each disk you would like to use as an OSD on that node, and additionally on the other nodes in the cluster. Cluster status can be verified using:
These installation instructions use the Canonical produced and supplied Ceph rock — this OCI compliant image provides a drop in replacement for the upstream Ceph OCI image.
Charmed Ceph is Canonical's fully automated, model-driven approach to installing and managing Ceph. Charmed Ceph is generally deployed on bare-metal hardware that is managed by MAAS.
Let our Ceph experts help you take the next step.
© 2026 Canonical Ltd.
Ubuntu and Canonical are registered trademarks of Canonical Ltd.