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

# OpenStack Integrator

[Canonical Kubernetes](https://charmhub.io/publisher/containers "View all packages from Canonical Kubernetes")

* [Canonical Kubernetes](https://charmhub.io/publisher/containers "View all packages from Canonical Kubernetes")

Platform:

24.04

22.04

20.04

18.04

16.04

stable d164aca

```
juju deploy openstack-integrator
```

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

* [auth-url](https://charmhub.io/openstack-integrator/configurations#auth-url)
* [bs-version](https://charmhub.io/openstack-integrator/configurations#bs-version)
* [credentials](https://charmhub.io/openstack-integrator/configurations#credentials)
* [domain-id](https://charmhub.io/openstack-integrator/configurations#domain-id)
* [domain-name](https://charmhub.io/openstack-integrator/configurations#domain-name)
* [endpoint-tls-ca](https://charmhub.io/openstack-integrator/configurations#endpoint-tls-ca)
* [floating-network-id](https://charmhub.io/openstack-integrator/configurations#floating-network-id)
* [ignore-volume-az](https://charmhub.io/openstack-integrator/configurations#ignore-volume-az)
* [internal-lb](https://charmhub.io/openstack-integrator/configurations#internal-lb)
* [lb-enabled](https://charmhub.io/openstack-integrator/configurations#lb-enabled)
* [lb-floating-network](https://charmhub.io/openstack-integrator/configurations#lb-floating-network)
* [lb-method](https://charmhub.io/openstack-integrator/configurations#lb-method)
* [lb-port](https://charmhub.io/openstack-integrator/configurations#lb-port)
* [lb-subnet](https://charmhub.io/openstack-integrator/configurations#lb-subnet)
* [manage-security-groups](https://charmhub.io/openstack-integrator/configurations#manage-security-groups)
* [password](https://charmhub.io/openstack-integrator/configurations#password)
* [project-domain-id](https://charmhub.io/openstack-integrator/configurations#project-domain-id)
* [project-domain-name](https://charmhub.io/openstack-integrator/configurations#project-domain-name)
* [project-id](https://charmhub.io/openstack-integrator/configurations#project-id)
* [project-name](https://charmhub.io/openstack-integrator/configurations#project-name)
* [region](https://charmhub.io/openstack-integrator/configurations#region)
* [snapd\_refresh](https://charmhub.io/openstack-integrator/configurations#snapd_refresh)
* [subnet-id](https://charmhub.io/openstack-integrator/configurations#subnet-id)
* [trust-device-path](https://charmhub.io/openstack-integrator/configurations#trust-device-path)
* [user-domain-id](https://charmhub.io/openstack-integrator/configurations#user-domain-id)
* [user-domain-name](https://charmhub.io/openstack-integrator/configurations#user-domain-name)
* [username](https://charmhub.io/openstack-integrator/configurations#username)
* [web-proxy-enable](https://charmhub.io/openstack-integrator/configurations#web-proxy-enable)

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

* auth-url | string

  The URL of the keystone API used to authenticate. On OpenStack control panels,
  this can be found at Access and Security > API Access > Credentials.
* bs-version | string

  Used to override automatic version detection for block storage usage.
  Valid values are v1, v2, v3 and auto. When auto is specified automatic
  detection will select the highest supported version exposed by the
  underlying OpenStack cloud. If not set, will use the upstream default.
* credentials | string

  The base64-encoded contents of a JSON file containing OpenStack credentials.

  The credentials must contain the following keys: auth-url, region, username,
  password, project-name, user-domain-name, and project-domain-name.

  It could also contain a base64-encoded CA certificate in endpoint-tls-ca key value.

  This can be used from bundles with 'include-base64://' (see
  https://jujucharms.com/docs/stable/charms-bundles#setting-charm-configurations-options-in-a-bundle),
  or from the command-line with 'juju config openstack-integrator credentials="$(base64 /path/to/file)"'.

  It is strongly recommended that you use 'juju trust' instead, if available.
* domain-id | string

  ID of domain where you want to create your resources.
* domain-name | string

  Name of domain where you want to create your resources.
* endpoint-tls-ca | string

  A CA certificate that can be used to verify the target cloud API endpoints.
  Use 'include-base64://' in a bundle to include a certificate. Otherwise,
  pass a base64-encoded certificate (base64 of "-----BEGIN" to "-----END")
  as a config option in a Juju CLI invocation.
* floating-network-id | string

  If set, it will be passed to integrated workloads to indicate that
  floating IPs should be created in the given network for load balancers
  that those workloads manage. For example, this will determine whether and
  where FIPs will be created by Kubernetes for LoadBalancer type services
  in the cluster.
* ignore-volume-az | boolean

  Used to influence availability zone use when attaching Cinder volumes.
  When Nova and Cinder have different availability zones, this should be
  set to true. This is most commonly the case where there are many Nova
  availability zones but only one Cinder availability zone. If not set,
  will use the upstream default.
* internal-lb | boolean

  Determines whether or not to create an internal load balancer
  (no floating IP) by default.
* lb-enabled | boolean

  Default: True

  Whether or not to enable the LoadBalancer type of Services integration.
  Enabled by default.
* lb-floating-network | string

  If set, this charm will assign a floating IP in this network (name or ID)
  for load balancers created for other charms related on the loadbalancer
  endpoint.
* lb-method | string

  Default: ROUND\_ROBIN

  Algorithm that will be used by load balancers, which must be one of:
  ROUND\_ROBIN, LEAST\_CONNECTIONS, SOURCE\_IP. This applies both to load
  balancers managed by this charm for applications related via the
  loadbalancer endpoint, as well as to load balancers managed by integrated
  workloads, such as Kubernetes.
* lb-port | int

  Default: 443

  Port to use for load balancers created by this charm for other charms
  related on the loadbalancer endpoint.
* lb-subnet | string

  Override the subnet (name or ID) in which this charm will create load
  balancers for other charms related on the loadbalancer endpoint. If not
  set, the subnet over which the requesting application is related will be
  used.
* manage-security-groups | boolean

  Whether or not each load balancer should have its own security group, or
  if all load balancers should use the default security group for the
  project. This applies both to load balancers managed by this charm for
  applications related via the loadbalancer endpoint, as well as to load
  balancers managed by integrated workloads, such as Kubernetes.
* password | string

  Password of a valid user set in keystone.
* project-domain-id | string

  ID of the project domain where you want to create your resources.
* project-domain-name | string

  Name of the project domain where you want to create your resources.
* project-id | string

  ID of project where you want to create your resources.
* project-name | string

  Name of project where you want to create your resources.
* region | string

  Name of the region where you want to create your resources.
* snapd\_refresh | string

  How often snapd handles updates for installed snaps. The default (an empty string) is 4x per day. Set to "max" to check once per month based on the charm deployment date. You may also set a custom string as described in the 'refresh.timer' section here:
  https://forum.snapcraft.io/t/system-options/87
* subnet-id | string

  If set, it will be passed to integrated workloads to indicate in what
  subnet load balancers should be created. For example, this will determine
  what subnet Kubernetes uses for LoadBalancer type services in the
  cluster.
* trust-device-path | boolean

  In most scenarios the block device names provided by Cinder (e.g.
  /dev/vda) can not be trusted. This boolean toggles this behavior. Setting
  it to true results in trusting the block device names provided by Cinder.
  The value of false results in the discovery of the device path
  based on its serial number and /dev/disk/by-id mapping and is the
  recommended approach. If not set, will use the upstream default.
* user-domain-id | string

  ID of the user domain where you want to create your resources.
* user-domain-name | string

  Name of the user domain where you want to create your resources.
* username | string

  Username of a valid user set in keystone.
* web-proxy-enable | boolean

  Whether the applications managed by this charm should be
  proxied using juju's model-config juju-\*-proxy settings.
  (See https://documentation.ubuntu.com/juju/latest/reference/juju-cli/list-of-juju-cli-commands/model-config/).
