# Adding a New Region to an Existing Deployment

You can add a new region to an already deployed setup using the `airctl`. This allows you to expand your environment without redeploying the entire system.

### Steps to Add a New Region

1. Update the Configuration File:

Edit the `airctl-config.yaml` file and append the new region name under the `duRegion` field. Example:

{% tabs %}
{% tab title="Bash" %}

```bash
# cat /opt/pf9/airctl/conf/airctl-config.yaml | grep -i region
duRegion: Infra RegionOne NewRegion
```

{% endtab %}
{% endtabs %}

2. Run the add-Region Command:

{% tabs %}
{% tab title="Bash" %}

```bash
airctl add-region --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endtab %}
{% endtabs %}

3. Verify the Region Addition:

Once the command completes, verify that the new region has been successfully added. You should now see the newly added region reflected in both the **state file** and the **`airctl status`** output.

{% tabs %}
{% tab title="Bash" %}

```bash
airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endtab %}
{% endtabs %}

Here is the sample output.

{% tabs %}
{% tab title="Bash" %}

```bash
------------- deployment details ---------------
fqdn:                airctl-1-4108764-426.platform9.localnet
region:              airctl-1-4108764-426
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-2561
-------- region service status ----------
desired services:     30
ready services:       30


------------- deployment details ---------------
fqdn:                airctl-1-4108764-426-regionone.platform9.localnet
region:              airctl-1-4108764-426-regionone
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-2561
-------- region service status ----------
desired services:     77
ready services:       77

------------- deployment details ---------------
fqdn:                airctl-1-4108764-426-newregion.platform9.localnet
region:              airctl-1-4108764-426-newregion
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-2561
-------- region service status ----------
desired services:     77
ready services:       77
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Bash" %}

```bash
# cat .airctl/state.yaml
...
regions:
    - name: Infra
      fqdn: airctl-1-4108764-426.platform9.localnet
      dbHostname: percona-db-pxc-db-haproxy.foo.svc.cluster.local
      dbPassword: *********
    - name: RegionOne
      fqdn: airctl-1-4108764-426-regionone.platform9.localnet
      dbHostname: percona-db-pxc-db-haproxy.foo-regionone.svc.cluster.local
      dbPassword: *********
    - name: NewRegion
      fqdn: airctl-1-4108764-426-newregion.platform9.localnet
      dbHostname: percona-db-pxc-db-haproxy.foo-regionone.svc.cluster.local
      dbPassword: *********
```

{% endtab %}
{% endtabs %}

This process ensures a seamless addition of new regions to your deployment while maintaining consistency across configuration and runtime state.