---
title: Charmhub | Deploy Ceph Proxy using Charmhub - The Open Operator Collection
description: Deploy the latest version of Ceph Proxy on any cloud. Proxy to Juju external
  Ceph cluster
url: https://charmhub.io/ceph-proxy
---

# Ceph Proxy

[OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers")

* [OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers")
* [Cloud](https://charmhub.io/?filter=cloud)
* [Storage](https://charmhub.io/?filter=storage)

Platform:

26.04

24.04

23.10

23.04

22.10

22.04

21.10

21.04

20.10

+3

quincy/stable 421

```
juju deploy ceph-proxy --channel quincy/stable
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# Overview

[Ceph](https://ceph.io/) 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](https://charmhub.io/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](https://charmbui.io/ceph-radosgw) and [ceph-fs](https://charmbui.io/ceph-fs) charms.

**Important:** This documentation supports version `3.x` of the Juju client.
See the [OpenStack Charm
guide](https://docs.openstack.org/charm-guide/latest/project/support-notes.html#breaking-changes-between-juju-2-9-x-and-3-x) if you are using the `2.9.x` client.

# Usage

## Configuration

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](https://juju.is/docs/configuring-applications) for details on configuring applications.

#### `fsid`

The `fsid` option supplies the UUID of the external cluster.

#### `admin-key`

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

#### `monitor-hosts`

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

## Deployment

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

```
    ceph-proxy:
        fsid: a4f1fb08-c83d-11ea-8f4a-635b3b062931
        admin-key: AQCJvBFfWX+GLhAAln5dFd1rZekcGLyMmy58bQ==
        monitor-hosts: '10.246.114.21:6789 10.246.114.22:6789 10.246.114.7:6789'
```

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
```

## Actions

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

# Bugs

Please report bugs on [Launchpad](https://bugs.launchpad.net/charm-ceph-proxy/+filebug).

For general charm questions refer to the [OpenStack Charm Guide](https://docs.openstack.org/charm-guide).

---

[Help improve this document in the forum](https://discourse.charmhub.io/t/ceph-proxy-docs-index/11218) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 3 years ago.