> ## Documentation Index
> Fetch the complete documentation index at: https://controlplanecorporation-majid-docs-content-expansion.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Location

> Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.

## Overview

Locations show the available geographical locations for each of the following cloud providers:

* Amazon Web Services (AWS)
* Google Cloud Platform (GCP)
* Microsoft Azure
* Oracle Cloud Infrastructure (OCI)

Locations are scoped to an [org](/reference/org), and an org administrator enables or disables the ones a [GVC](/reference/gvc) may select.

A new org is seeded with a working subset of the built-in catalog, and every location present in an org starts enabled. Disabling a location removes the [workloads](/concepts/workload) running in it; enabling one provisions every workload whose GVC selects it.

<Note>
  If a company is restricted for legal or compliance reasons to only use certain cloud providers, disabling those providers will ensure that workloads will not be deployed to those providers.
</Note>

## Locations

Control Plane can enable any cloud provider location.

If a location is not shown, email [support@controlplane.com](mailto:support@controlplane.com) with the provider and location and it will be provisioned.

## Custom Locations

CPLN BYOK enables you to add new locations by registering your own Kubernetes clusters as locations in the Control Plane platform.
For a guide on how to create new BYOK locations and further details, [refer to the BYOK documentation](/byok/overview).

## Built-in Tags

Each location has the following built-in [tags](/core/misc#tags):

* `cpln/city=VALUE`
* `cpln/state=VALUE`
* `cpln/country=VALUE`
* `cpln/continent=VALUE`

These are set from the location's geographic coordinates, so a [GVC](/reference/gvc) can select locations with a [query](/core/query) on them instead of naming each one.

## Public IPs

The list of public IPs for each cloud provider and region can be obtained.

<Tabs>
  <Tab title="Console UI">
    Navigate to the `Locations` list page from the main navigation bar.
    Select a location to view the IP ranges listed on the `Info` page.
  </Tab>

  <Tab title="CLI">
    Use the command below to view the IP ranges of all locations.

    ```bash theme={null}
    cpln location get -o json
    ```

    The output can also be formatted as YAML by using the flag `-o yaml` instead of `-o json`.

    To view a single location, name it:

    ```bash theme={null}
    cpln location get aws-us-west-2 -o json
    ```

    See the [CLI location command reference](/cli-reference/commands/location) for more details.
  </Tab>

  <Tab title="API">
    The location list endpoint and location-specific endpoint return the location object with the `ipRanges` property.

    See the [Get All Locations API endpoint](/api-reference/location/get-all-locations) for details.
  </Tab>
</Tabs>

<Tip>
  The list of IPs may be required by external services that restrict which IPs are allowed to access them.

  The IPs may change when underlying infrastructure changes. Control Plane recommends automating location API checks and updating external services' allowed IP address lists when changes occur.
</Tip>

## Permissions

The permissions below are used to define [policies](/reference/policy) together with one or more of the four [principal types](/concepts/access-control):

| Permission | Description                              | Implies                         |
| :--------- | :--------------------------------------- | :------------------------------ |
| create     | Create new locations                     |                                 |
| delete     | Delete BYOK locations                    |                                 |
| edit       | Modify existing locations                | view                            |
| manage     | Full access                              | create, delete, edit, use, view |
| use        | Use this location for workload placement | view                            |
| view       | Read-only access                         |                                 |

## Access Report

Displays the permissions granted to principals for the location.

## CLI

To view the CLI documentation for locations, see the [Location CLI reference](/cli-reference/commands/location).