Block Device Quick StartΒΆ

To use this guide, you must have executed the procedures in the Object Store Quick Start guide first. Ensure your Ceph Storage Cluster is in an active + clean state before working with the Ceph Block Device. Execute this quick start on the admin node.


The Ceph Block Device is also known as RBD or RADOS Block Device.

  1. Install ceph-common.

    sudo apt-get install ceph-common
  2. Create a block device image.

    rbd create foo --size 4096      [-m {mon-IP}] [-k /path/to/ceph.client.admin.keyring]
  3. Load the rbd client module.

    sudo modprobe rbd
  4. Map the image to a block device.

    sudo rbd map foo --pool rbd --name client.admin [-m {mon-IP}] [-k /path/to/ceph.client.admin.keyring]
  5. Use the block device. In the following example, create a file system.

    sudo mkfs.ext4 -m0 /dev/rbd/rbd/foo
    This may take a few moments.
  6. Mount the file system.

    sudo mkdir /mnt/ceph-block-device
    sudo mount /dev/rbd/rbd/foo /mnt/ceph-block-device
    cd /mnt/ceph-block-device


Mount the block device on the client machine, not the server machine. See FAQ for details.

See block devices for additional details.