Ceph Proxy

  • By OpenStack Charmers
  • Cloud
Channel Revision Published Runs on
latest/edge 73 06 Nov 2023
Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.04
quincy/stable 72 14 Sep 2023
Ubuntu 23.04 Ubuntu 22.10 Ubuntu 22.04
reef/stable 73 01 Dec 2023
Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.04
reef/candidate 73 06 Nov 2023
Ubuntu 23.10 Ubuntu 23.04 Ubuntu 22.04
pacific/stable 57 05 Aug 2022
Ubuntu 20.04
octopus/stable 55 23 Jan 2023
Ubuntu 20.04 Ubuntu 18.04
nautilus/edge 56 25 Feb 2022
Ubuntu 18.04
mimic/edge 56 25 Feb 2022
Ubuntu 18.04
luminous/edge 53 24 Feb 2022
Ubuntu 18.04 Ubuntu 16.04
juju deploy ceph-proxy --channel quincy/stable
Show information


23.04 22.10 22.04


Ceph is a unified, distributed storage system designed for excellent performance, reliability, and scalability.

The ceph-proxy charm deploys a proxy that acts as a ceph-mon application for an external Ceph cluster. It joins a non-charmed Ceph cluster to a Juju model.

The charm works with traditional Ceph charm clients (e.g. cinder, glance, nova-compute) but it also supports the ceph-radosgw and ceph-fs charms.

Important: This documentation supports version 3.x of the Juju client. See the OpenStack Charm guide if you are using the 2.9.x client.



This section covers common and/or important configuration options. See file config.yaml for the full list of options, along with their descriptions and default values. See the Juju documentation for details on configuring applications.


The fsid option supplies the UUID of the external cluster.


The admin-key option supplies the admin Cephx key of the external cluster.


The monitor-hosts option supplies the network addresses (and ports) of the Monitors of the external cluster.


Let file ceph-proxy.yaml contain the deployment configuration:

        fsid: a4f1fb08-c83d-11ea-8f4a-635b3b062931
        admin-key: AQCJvBFfWX+GLhAAln5dFd1rZekcGLyMmy58bQ==
        monitor-hosts: ''

To deploy:

juju deploy --config ceph-proxy.yaml ceph-proxy

Now add relations as you normally would between a ceph-mon application and another application, except substitute ceph-proxy for ceph-mon. For instance, to use the external Ceph cluster as the backend for an existing glance application:

juju integrate ceph-proxy:client glance:ceph


Many of the ceph-mon charm’s actions are supported. See file actions.yaml for the full list of actions, along with their descriptions.


Please report bugs on Launchpad.

For general charm questions refer to the OpenStack Charm Guide.

Help improve this document in the forum (guidelines). Last updated 5 months ago.