> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-vpn/list.md).

# list

The vpn list command retrieves a list of all VPN instances in your cluster. This command displays essential details such as VPN name, namespace, IP address, subnet, status, readiness, and age.

## Usage

```
cldkctl vpn list [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal:

```
cldkctl vpn list
```

2. The terminal displays a list of VPN instances along with their namespace, IP information, and status.

<figure><img src="/files/oaLkxzqcj7c3ViLDGMhw" alt=""><figcaption></figcaption></figure>

| Column     | Description                                                                   |
| ---------- | ----------------------------------------------------------------------------- |
| Namespace  | The namespace in which the VPN instance is running.                           |
| Name       | The name of the VPN instance.                                                 |
| IP Address | The assigned public IP address of the VPN.                                    |
| IP Subnet  | The internal subnet address range associated with the VPN.                    |
| Status     | Indicates the current provisioning state of the VPN.                          |
| Ready      | Displays True if the VPN is active and ready, or False if still provisioning. |
| Age        | Duration since the VPN was created.                                           |

## Flags

{% hint style="info" %}
This command supports [global flags.](/cloudeka-api-list/global-flags.md) Refer to the Global Flags section for details
{% endhint %}

| Flag       | Description            |
| ---------- | ---------------------- |
| -h, --help | Help for list command. |