Deploying a development cluster

In order to develop on ceph, a Ceph utility,, allows you to deploy fake local cluster for development purpose.


It allows to deploy a fake local cluster on your machine for development purpose. It starts mon, osd and/or mds, or all of them if not specified.

To start your development cluster, type the following: [OPTIONS]... [mon] [osd] [mds]

In order to stop the cluster, you can type:



-i ip_address

Bind to the specified ip_address instead of guessing and resolve from hostname.


Keep old configuration files instead of overwritting theses.

-l, --localhost

Use localhost instead of hostanme.

-m ip[:port]

Specifies monitor ip address and port.

-n, --new

Create a new cluster.

-o config

Add config to all sections in the ceph configuration.


Start radosgw (ceph needs to be compiled with –radosgw), create an apache2 configuration file, and start apache2 with it (needs apache2 with mod_fastcgi) on port starting from 8000.


Use ceph-run as wrapper for mon/osd/mds.


Configure mds with small limit cache size.


Enable Cephx (on by default).


Disable Cephx.

-d, --debug

Launch in debug mode

--valgrind[_{osd,mds,mon}] 'valgrind_toolname [args...]'

Launch the osd/mds/mon/all the ceph binaries using valgrind with the specified tool and arguments.

Environment variables


Theses environment variables will contains the number of instances of the desired ceph process you want to start.