Skip to content
This repository

Chef cookbooks for Ceph

branch: master

Chef cookbook for deploying the Ceph storage system

Note: "knife cookbook upload" needs this directory to be named "ceph". Please clone the repository as

git clone ceph

(we cannot name this repository ceph.git, as that is the main project itself)


Installs and configures Ceph, a distributed network storage and filesystem designed to provide excellent performance, reliability, and scalability.

The current version is focused towards deploying Monitors and OSD on Ubuntu.

For documentation on how to use this cookbook, refer to the USAGE section.

Work in progress:

  • RadosGW
  • MDS
  • Other Distro (Debian, RHEL/CentOS, FC)



Tested as working:

  • Ubuntu Precise (12.04)


The ceph cookbook requires the following cookbooks from Opscode:

  • apt
  • apache2


Ceph Rados Gateway

  • node[:ceph][:radosgw][:api_fqdn]
  • node[:ceph][:radosgw][:admin_email]
  • node[:ceph][:radosgw][:rgw_addr]



Ceph cluster design is beyond the scope of this README, please turn to the public wiki, mailing lists, visit our IRC channel, or contact Inktank:

Ceph Monitor

Ceph monitor nodes should use the ceph-mon role.


  • ceph::default
  • ceph::conf

Ceph Metadata Server

Ceph metadata server nodes should use the ceph-mds role.


  • ceph::default

Ceph OSD

Ceph OSD nodes should use the ceph-osd role


  • ceph::default
  • ceph::conf

Ceph Rados Gateway

Ceph Rados Gateway nodes should use the ceph-radosgw role


Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Something went wrong with that request. Please try again.