Charmed Ceph is a software-defined storage solution that provides object, block and file storage on commodity hardware.
Charmed Ceph makes it easy to use and deploy Ceph. It provides a simpler way to deliver Ceph to users using a set of scripts called charms that are deployed with Juju.
Corporate users can benefit from the robust and manageable full-suite storage solution, and the ease with which their Ceph clusters can be deployed with Charmed Ceph.
This is a monolithic repository, or monorepo, that contains the core charms used in Ceph deployment. It also contains other associated charm libraries and utilities that make up the Ceph ecosystem that can be deployed via Juju.
In the past, each charm resided in its own repository, making changes, especially larger changes that involved multiple components, difficult to make. We decided to consolidate all these charms and their associated components into this single repository to make handling changes easier.
Each of the charms define a specific Ceph application that can be deployed. The charms usually work together, i.e: they are often deployed together via Juju integrations.
In addition to the charms, the monorepo also contains libraries, dependencies, modules and test scripts, including:
- charms.ceph: Common support library used by the charms.
- constraints: List of common dependencies shared by the charms.
- terraform: Maintains terraform modules used for charm deployments.
- tests: Miscellaneous scripts used to facilitate testing.
Each individual charm contains a README section with details about the specific charm, including its description, functionality, usage and contributing guide.
See charmhub for more information about the charms.
The OpenStack charm guideprovides guides for working with charms, including development and support notes.
The OpenStack charms deployment guide demonstrates how to deploy and configure charms manually to build an OpenStack cloud.
We warmly welcome community contributions, suggestions, fixes, and constructive feedback. If you find any errors or have suggestions for improvements, please report a bug on launchpad on the specific component (for example, report a ceph-dashboard charm bug in the Ceph Dashboard charm project on Launchpad).
[!NOTE]
Please read the guide for submitting a software bug before doing so. This will considerably reduce the time needed to triage your bug.
Join our Matrix forum to engage with our community and get support.
We abide by the Ubuntu Code of Conduct.
If you’re interested in contributing to the code or documentation for any of the repositories in this monorepo, our community section is the best place to start.
The software contributions section has software contribution guidelines, while documentation contributions contains guidelines for documentation contributions.
See the LICENSE file in each charm for license information.
© 2025 Canonical Ltd.