Skip to content

ceph/ceph-container

Repository files navigation

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.

Ceph Daemon Stars Ceph Daemon Pulls

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

Presentations

Restructuring ceph-container