---
title: Charmhub | Deploy Designate using Charmhub - The Open Operator Collection
description: Deploy the latest version of Designate on any cloud. Designate provides
  DNSaaS services for OpenStack
url: https://charmhub.io/designate
---

# Designate

[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)
* [Networking](https://charmhub.io/?filter=networking)

Platform:

24.04

23.10

23.04

22.10

22.04

20.04

18.04

yoga/stable 4cccfb9

```
juju deploy designate --channel yoga/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

This charm provides Designate (DNSaaS) for an OpenStack Cloud.

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

Designate relies on services from the mysql, rabbitmq-server and keystone charms:

```
juju deploy designate
juju deploy mysql
juju deploy rabbitmq-server
juju deploy keystone
juju deploy memcached
juju integrate designate memcached
juju integrate designate mysql
juju integrate designate rabbitmq-server
juju integrate designate keystone
```

To add support for DNS record auto-generation when Neutron ports and floating IPs are created the charm needs a relation with neutron-api charm:

```
juju deploy neutron-api
juju integrate designate neutron-api
```

The charm needs to store DNS records. This can be achieved by setting the dns-slave config option or by relating to the designate-bind charm:

```
juju deploy designate-bind
juju integrate designate designate-bind
```

For Queens and later, the nameservers config value must be set:

```
juju config designate nameservers="ns1.example.com. ns2.example.com."
```

## Policy Overrides

Policy overrides is an **advanced** feature that allows an operator to override the default policy of an OpenStack service. The policies that the service supports, the defaults it implements in its code, and the defaults that a charm may include should all be clearly understood before proceeding.

> **Caution**: It is possible to break the system (for tenants and other services) if policies are incorrectly applied to the service.

Policy statements are placed in a YAML file. This file (or files) is then (ZIP) compressed into a single file and used as an application resource. The override is then enabled via a Boolean charm option.

Here are the essential commands (filenames are arbitrary):

```
zip overrides.zip override-file.yaml
juju attach-resource designate policyd-override=overrides.zip
juju config designate use-policyd-override=true
```

See appendix [Policy Overrides](https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/app-policy-overrides.html) in the [OpenStack Charms Deployment Guide](https://docs.openstack.org/project-deploy-guide/charm-deployment-guide) for a thorough treatment of this feature.

# Bugs

Please report bugs on [Launchpad](https://bugs.launchpad.net/charm-designate/+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/designate-docs-index/11220) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 3 years ago.