ceph-container
As of August 2021, new container images are pushed to quay.io registry only. Docker hub won't receive new content for that specific image but current images remain available.
Build Ceph into container images with upstream support for the latest few Ceph releases on CentOS. ceph-container also supports builds for multiple distributions.
Find available container image tags
All tags for ceph/ceph can be found on the quay.io registry. visit As an alternative you can still use the docker hub registry but without the most recent images. visit
Alternatively, you can run the following command (install jq first):
For quay.io registry
$ curl -s -L https://quay.io/api/v1/repository/ceph/ceph/tag?page_size=100 | jq '."tags"[] .name'For docker hub registry
$ curl -s https://registry.hub.docker.com/v2/repositories/ceph/ceph/tags/?page_size=100 | jq '."results"[] .name'-All tags for ceph/{daemon-base,daemon,demo} can be found on the quay.io registry. -For the daemon-base tags visit -For the daemon tags visit -For the demo tags visit
Alternatively, you can run the following command (install jq first):
For quay.io registry
$ curl -s -L https://quay.io/api/v1/repository/ceph/daemon/tag?page_size=100 | jq '."tags"[] .name'For docker hub registry
$ curl -s https://registry.hub.docker.com/v2/repositories/ceph/daemon/tags/?page_size=100 | jq '."results"[] .name'Be careful, this will only show the latest 100 tags. To improve your curl you can pass a page number: https://registry.hub.docker.com/v2/repositories/ceph/demo/tags/?page_size=100&page=2 or use the following bash script to search multiple pages:
This will search for all tags with both stable and nautlius in the latest 2000
for i in {1..20}; do \
curl -s https://registry.hub.docker.com/v2/repositories/ceph/demo/tags/?page_size=100\&page=$i | jq '."results"[] .name'; \
done | awk '/stable/ && /nautilus/'Stable images
Since everyone doesn't use Docker Hub API and Docker Hub WebUI doesn't paginate. It's hard to see all available stable images.
Starting August 22th 2018, Ubuntu images are no longer supported. Only openSUSE and CentOS images will be shipped.
Here is an example list of available stable Ceph images
ceph/daemon:v3.0.5-stable-3.0-luminous-centos-7
ceph/daemon:v3.0.5-stable-3.0-luminous-centos-7-x86_64
ceph/daemon:v3.0.5-stable-3.0-luminous-centos-7-aarch64
ceph/daemon:v3.0.3-stable-3.0-luminous-centos-7-x86_64
ceph/daemon:v3.0.2-stable-3.0-luminous-centos-7-x86_64
ceph/daemon:v3.0.1-stable-3.0-luminous-centos-7-x86_64
ceph/daemon:tag-stable-3.0-luminous-centos-7
Development images
It is possible to build a container running the latest development release (main). It also includes the latest development packages from the nfs-ganesha project.
This is only available on CentOS with the following command :
make FLAVORS="main,centos,7" build
Alternatively, you can build a container image based on wip-* branch:
make FLAVORS="wip-nautilus-superb,centos,7" build
To build your branch on Centos 7 on the wip-nautilus-superb branch. But please make sure the
branch name contains the release name from which the branch is created.
It's also possible to use the Ceph development builds instead of the stable one (except for main).
The ceph packages will be pulled from shaman/chacra repositories.
The Ceph development images are using the latest-<release>-devel tag where release is the ceph
release name (ie: luminous, mimic, nautilus)
make CEPH_DEVEL=true FLAVORS="nautilus,centos,7" build
This will generate the following container images:
ceph/daemon:latest-nautilus-devel
ceph/daemon-base:latest-nautilus-devel
Core Components
ceph/demo-base: Base container image containing Ceph core components.ceph/daemon: All-in-one container containing all Ceph daemons.ceph/demo: A demo image for Ceph containers.
See README files in subdirectories for instructions on using containers.
Building ceph-container
make is used for ceph-container builds. See make help for all make options.
Specifying flavors for make
The make tooling allows the environment variable FLAVORS to be optionally set by the user to
define which flavors to operate on. Flavor specifications follow a strict format that declares what
Ceph version to build and what container image to use as the base for the build. See make help for
a full description.
Building a single flavor
Once the flavor is selected, specify its name in the FLAVORS environment variable and call the
build target:
make FLAVORS=luminous,centos,7 build
Building multiple flavors
Multiple flavors are specified by separating each flavor by a space and surrounding the entire specification in quotes and built the same as a single flavor:
make FLAVORS="luminous,centos,7 mimic,opensuse,42.3" build
Flavors can be built in parallel easily with the build.parallel target:
make FLAVORS="<flavor> <other flavor> <...>" build.parallel
Building with a specific version of Ceph
Some distributions can select a specific version of Ceph to install. You just have to append the required version to the ceph release code name.
The required version will be saved in CEPH_POINT_RELEASE variable (including the version separator).
The version separator is usually a dash ('-') or an equal sign ('=').
CEPH_POINT_RELEASE remains empty if no point release is given.
Note that CEPH_VERSION variable still feature the ceph code name, luminous in this example.
make FLAVORS=luminous-12.2.2,centos,7 build