# Viewing and Checking Region Status

This section explains how to list all deployed regions in <code class="expression">space.vars.product\_name</code> and check their current deployment status using the `airctl` CLI tool.

## List All Deployed Regions

To view the list of all regions currently deployed in the Self-Hosted version of <code class="expression">space.vars.product\_name</code> , run:

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

```bash
/opt/pf9/airctl/airctl get-regions --config /opt/pf9/airctl/conf/airctl-config.yaml
```

{% endtab %}
{% endtabs %}

This command retrieves region names directly from the state file and lists all currently active regions. Use it to confirm which regions are available before performing operations such as backups, deletions, or status checks.

Example output:

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

```bash
$ /opt/pf9/airctl/airctl get-regions --config /opt/pf9/airctl/conf/airctl-config.yaml 
Deployed Regions:
• Infra
• LON
```

{% endtab %}
{% endtabs %}

## Check Region Status

The `airctl status` command provides detailed information about the health and service status of each region.

By default, it shows the status of all deployed regions, including service counts and readiness indicators.

### Status Command Flags

The `airctl status` command supports the following flags to customize output:

* \--region : Specifies which region’s status to display. **This flag is mandatory** when using `--ready` or `--desired`.
* \--ready: Displays **only the number of Ready services** for the specified region.
* \--desired: Displays **only the number of Desired services** for the specified region

{% hint style="info" %}
**Info**

* The `--ready` and `--desired` flags are **mutually exclusive** — only one can be used at a time.
* When used, these flags print **only the number of services** in the specified state for the given region.
  {% endhint %}

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

```bash
Usage:
  airctl status [flags]

Flags:
      --desired         Show only the number of desired services for each region
  -h, --help            help for status
      --ready           Show only the number of ready services for each region
  -r, --region string   Display status for a specific region

Global Flags:
      --config string   config file (default is $HOME/airctl-config.yaml)
      --json            json output for commands (configure-hosts only currently)
      --quiet           disable spinners
      --verbose         print verbose logs to the console
```

{% endtab %}
{% endtabs %}

### Examples:

View All Regions and their Status :

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

```bash
$ /opt/pf9/airctl/airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml
------------- deployment details ---------------
fqdn:                airctl-1-4161345-238.platform9.localnet
region:              airctl-1-4161345-238
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-69
-------- region service status ----------
desired services:     30
ready services:       30


------------- deployment details ---------------
fqdn:                airctl-1-4161345-238-lon.platform9.localnet
region:              airctl-1-4161345-238-lon
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-69
-------- region service status ----------
desired services:     84
ready services:       84
```

{% endtab %}
{% endtabs %}

View status for a specific region :

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

```bash
$ /opt/pf9/airctl/airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml --region Infra
------------- deployment details ---------------
fqdn:                airctl-1-4161345-238.platform9.localnet
region:              airctl-1-4161345-238
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-69
-------- region service status ----------
desired services:     30
ready services:       30
```

{% endtab %}
{% endtabs %}

View Ready Services for a Region :

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

```bash
$ /opt/pf9/airctl/airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml --ready --region LON
84
```

{% endtab %}
{% endtabs %}

View Desired Services for a Region :

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

```bash
$ /opt/pf9/airctl/airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml --desired --region LON
84
```

{% endtab %}
{% endtabs %}