---
title: Charmhub | Deploy Gnocchi using Charmhub - The Open Operator Collection
description: Deploy the latest version of Gnocchi on any cloud.
url: https://charmhub.io/gnocchi/configurations
---

# Gnocchi

[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)

Platform:

24.04

23.10

23.04

22.10

22.04

20.04

18.04

yoga/stable 79840c5

```
juju deploy gnocchi --channel yoga/stable
```

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

* [action-managed-upgrade](https://charmhub.io/gnocchi/configurations#action-managed-upgrade)
* [bluestore-compression-algorithm](https://charmhub.io/gnocchi/configurations#bluestore-compression-algorithm)
* [bluestore-compression-max-blob-size](https://charmhub.io/gnocchi/configurations#bluestore-compression-max-blob-size)
* [bluestore-compression-max-blob-size-hdd](https://charmhub.io/gnocchi/configurations#bluestore-compression-max-blob-size-hdd)
* [bluestore-compression-max-blob-size-ssd](https://charmhub.io/gnocchi/configurations#bluestore-compression-max-blob-size-ssd)
* [bluestore-compression-min-blob-size](https://charmhub.io/gnocchi/configurations#bluestore-compression-min-blob-size)
* [bluestore-compression-min-blob-size-hdd](https://charmhub.io/gnocchi/configurations#bluestore-compression-min-blob-size-hdd)
* [bluestore-compression-min-blob-size-ssd](https://charmhub.io/gnocchi/configurations#bluestore-compression-min-blob-size-ssd)
* [bluestore-compression-mode](https://charmhub.io/gnocchi/configurations#bluestore-compression-mode)
* [bluestore-compression-required-ratio](https://charmhub.io/gnocchi/configurations#bluestore-compression-required-ratio)
* [debug](https://charmhub.io/gnocchi/configurations#debug)
* [dns-ha](https://charmhub.io/gnocchi/configurations#dns-ha)
* [haproxy-client-timeout](https://charmhub.io/gnocchi/configurations#haproxy-client-timeout)
* [haproxy-connect-timeout](https://charmhub.io/gnocchi/configurations#haproxy-connect-timeout)
* [haproxy-queue-timeout](https://charmhub.io/gnocchi/configurations#haproxy-queue-timeout)
* [haproxy-server-timeout](https://charmhub.io/gnocchi/configurations#haproxy-server-timeout)
* [memcached-coordinator-lock-timeout](https://charmhub.io/gnocchi/configurations#memcached-coordinator-lock-timeout)
* [openstack-origin](https://charmhub.io/gnocchi/configurations#openstack-origin)
* [os-admin-hostname](https://charmhub.io/gnocchi/configurations#os-admin-hostname)
* [os-admin-network](https://charmhub.io/gnocchi/configurations#os-admin-network)
* [os-internal-hostname](https://charmhub.io/gnocchi/configurations#os-internal-hostname)
* [os-internal-network](https://charmhub.io/gnocchi/configurations#os-internal-network)
* [os-public-hostname](https://charmhub.io/gnocchi/configurations#os-public-hostname)
* [os-public-network](https://charmhub.io/gnocchi/configurations#os-public-network)
* [region](https://charmhub.io/gnocchi/configurations#region)
* [s3-access-key-id](https://charmhub.io/gnocchi/configurations#s3-access-key-id)
* [s3-bucket-prefix](https://charmhub.io/gnocchi/configurations#s3-bucket-prefix)
* [s3-check-consistency-timeout](https://charmhub.io/gnocchi/configurations#s3-check-consistency-timeout)
* [s3-endpoint-url](https://charmhub.io/gnocchi/configurations#s3-endpoint-url)
* [s3-max-pool-connections](https://charmhub.io/gnocchi/configurations#s3-max-pool-connections)
* [s3-region-name](https://charmhub.io/gnocchi/configurations#s3-region-name)
* [s3-secret-access-key](https://charmhub.io/gnocchi/configurations#s3-secret-access-key)
* [ssl\_ca](https://charmhub.io/gnocchi/configurations#ssl_ca)
* [ssl\_cert](https://charmhub.io/gnocchi/configurations#ssl_cert)
* [ssl\_key](https://charmhub.io/gnocchi/configurations#ssl_key)
* [storage-backend](https://charmhub.io/gnocchi/configurations#storage-backend)
* [trusted-external-ca-cert](https://charmhub.io/gnocchi/configurations#trusted-external-ca-cert)
* [use-internal-endpoints](https://charmhub.io/gnocchi/configurations#use-internal-endpoints)
* [use-policyd-override](https://charmhub.io/gnocchi/configurations#use-policyd-override)
* [use-syslog](https://charmhub.io/gnocchi/configurations#use-syslog)
* [verbose](https://charmhub.io/gnocchi/configurations#verbose)
* [vip](https://charmhub.io/gnocchi/configurations#vip)
* [vip\_cidr](https://charmhub.io/gnocchi/configurations#vip_cidr)
* [vip\_iface](https://charmhub.io/gnocchi/configurations#vip_iface)
* [worker-multiplier](https://charmhub.io/gnocchi/configurations#worker-multiplier)

[Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration)

* action-managed-upgrade | boolean

  If True enables openstack upgrades for this charm via juju actions.
  You will still need to set openstack-origin to the new repository but
  instead of an upgrade running automatically across all units, it will
  wait for you to execute the openstack-upgrade action for this charm on
  each unit. If False it will revert to existing behavior of upgrading
  all units on config change.
* bluestore-compression-algorithm | string

  Compressor to use (if any) for pools requested by this charm.
  .
  NOTE: The ceph-osd charm sets a global default for this value (defaults
  to 'lz4' unless configured by the end user) which will be used unless
  specified for individual pools.
* bluestore-compression-max-blob-size | int

  Chunks larger than this are broken into smaller blobs sizing bluestore
  compression max blob size before being compressed on pools requested by
  this charm.
* bluestore-compression-max-blob-size-hdd | int

  Value of bluestore compression max blob size for rotational media on
  pools requested by this charm.
* bluestore-compression-max-blob-size-ssd | int

  Value of bluestore compression max blob size for solid state media on
  pools requested by this charm.
* bluestore-compression-min-blob-size | int

  Chunks smaller than this are never compressed on pools requested by
  this charm.
* bluestore-compression-min-blob-size-hdd | int

  Value of bluestore compression min blob size for rotational media on
  pools requested by this charm.
* bluestore-compression-min-blob-size-ssd | int

  Value of bluestore compression min blob size for solid state media on
  pools requested by this charm.
* bluestore-compression-mode | string

  Policy for using compression on pools requested by this charm.
  .
  'none' means never use compression.
  'passive' means use compression when clients hint that data is
  compressible.
  'aggressive' means use compression unless clients hint that
  data is not compressible.
  'force' means use compression under all circumstances even if the clients
  hint that the data is not compressible.
* bluestore-compression-required-ratio | float

  The ratio of the size of the data chunk after compression relative to the
  original size must be at least this small in order to store the
  compressed version on pools requested by this charm.
* debug | boolean

  Enable debug logging
* dns-ha | boolean

  Use DNS HA with MAAS 2.0. Note if this is set do not set vip settings
  below.
* haproxy-client-timeout | int

  Client timeout configuration in ms for haproxy, used in HA
  configurations. If not provided, default value of 90000ms is used.
* haproxy-connect-timeout | int

  Connect timeout configuration in ms for haproxy, used in HA
  configurations. If not provided, default value of 9000ms is used.
* haproxy-queue-timeout | int

  Queue timeout configuration in ms for haproxy, used in HA
  configurations. If not provided, default value of 9000ms is used.
* haproxy-server-timeout | int

  Server timeout configuration in ms for haproxy, used in HA
  configurations. If not provided, default value of 90000ms is used.
* memcached-coordinator-lock-timeout | int

  Default: 5

  Timeout value for coordinator lock heartbeat expiry. Increase this value
  if the lock is timing out before the heartbeat.
* openstack-origin | string

  Default: yoga

  Repository from which to install OpenStack.

  May be one of the following:

  distro (default)
  ppa:somecustom/ppa (PPA name must include OpenStack Release)
  deb url sources entry|key id
  or a supported Ubuntu Cloud Archive pocket.

  Supported Ubuntu Cloud Archive pockets include:

  cloud:trusty-liberty
  cloud:trusty-juno
  cloud:trusty-kilo
  cloud:trusty-liberty
  cloud:trusty-mitaka

  Note that updating this setting to a source that is known to
  provide a later version of OpenStack will trigger a software
  upgrade.
* os-admin-hostname | string

  The hostname or address of the admin endpoints created in the keystone
  identity provider.
  .
  This value will be used for admin endpoints. For example, an
  os-admin-hostname set to 'api-admin.example.com' with ssl enabled
  will create the following endpoint for neutron-api:
  .
  https://api-admin.example.com:9696/
* os-admin-network | string

  The IP address and netmask of the OpenStack Admin network (e.g.,
  192.168.0.0/24)
  .
  This network will be used for admin endpoints.
* os-internal-hostname | string

  The hostname or address of the internal endpoints created in the keystone
  identity provider.
  .
  This value will be used for internal endpoints. For example, an
  os-internal-hostname set to 'api-internal.example.com' with ssl enabled
  will create the following endpoint for neutron-api:
  .
  https://api-internal.example.com:9696/
* os-internal-network | string

  The IP address and netmask of the OpenStack Internal network (e.g.,
  192.168.0.0/24)
  .
  This network will be used for internal endpoints.
* os-public-hostname | string

  The hostname or address of the public endpoints created in the keystone
  identity provider.
  .
  This value will be used for public endpoints. For example, an
  os-public-hostname set to 'api-public.example.com' with ssl enabled
  will create the following endpoint for neutron-api:
  .
  https://api-public.example.com:9696/
* os-public-network | string

  The IP address and netmask of the OpenStack Public network (e.g.,
  192.168.0.0/24)
  .
  This network will be used for public endpoints.
* region | string

  Default: RegionOne

  OpenStack Region
* s3-access-key-id | string

  When using a S3 storage backend, user must provide the S3 access key ID.
* s3-bucket-prefix | string

  Default: gnocchi

  When using a S3 storage backend, user must provide the prefix to namespace metric bucket.
* s3-check-consistency-timeout | int

  Default: 60

  Maximum time to wait checking data consistency when writing to S3. Set to 0 to
  disable data consistency validation. (floating point value). Minimum value: 0
* s3-endpoint-url | string

  When using a S3 storage backend, user must provide the endpoint URL.
* s3-max-pool-connections | int

  Default: 50

  The maximum number of connections to keep in a connection pool. (integer value).
  Minimum value: 1
* s3-region-name | string

  When using a S3 storage backend, user must provide the S3 region name.
* s3-secret-access-key | string

  When using a S3 storage backend, user must provide the S3 secret access key.
* ssl\_ca | string

  TLS CA to use to communicate with other components in a deployment.
  .
  **NOTE**: This configuration option will take precedence over any
  certificates received over the `certificates` relation.
* ssl\_cert | string

  TLS certificate to install and use for any listening services.
  .
  **NOTE**: This configuration option will take precedence over any
  certificates received over the `certificates` relation.
* ssl\_key | string

  TLS key to use with certificate specified as `ssl_cert`.
  .
  **NOTE**: This configuration option will take precedence over any
  certificates received over the `certificates` relation.
* storage-backend | string

  Default: ceph

  Storage backend to use for Gnocchi. Valid options are ceph or s3.
* trusted-external-ca-cert | string

  Base 64 encoded SSL CA certificate to use for an encrypted S3 endpoint.
  To be used when the S3 certificates are not managed by charmed Vault.
* use-internal-endpoints | boolean

  Openstack mostly defaults to using public endpoints for
  internal communication between services. If set to True this option
  will configure services to use internal endpoints where possible.
* use-policyd-override | boolean

  If True then use the resource file named 'policyd-override' to install
  override YAML files in the service's policy.d directory. The resource
  file should be a ZIP file containing at least one yaml file with a .yaml
  or .yml extension. If False then remove the overrides.
* use-syslog | boolean

  Setting this to True will allow supporting services to log to syslog.
* verbose | boolean

  Enable verbose logging
* vip | string

  Virtual IP(s) to use to front API services in HA configuration.

  If multiple networks are being used, a VIP should be provided for each
  network, separated by spaces.
* vip\_cidr | int

  Default: 24

  Default CIDR netmask to use for HA vip when it cannot be automatically
  determined.
* vip\_iface | string

  Default: eth0

  Default network interface to use for HA vip when it cannot be
  automatically determined.
* worker-multiplier | float

  The CPU core multiplier to use when configuring worker processes. By
  default, the number of workers for each daemon is set to twice the number
  of CPU cores a service unit has. This default value will be capped
  to 4 workers unless this configuration option is set.
