---
name: schematics-cross_region_deployment
title: Deploying resources in a specific region or across multiple regions
description: You can add multiple multiple provider configurations to the `provider` block to specify the regions where you want to deploy your Cloud resources. For more information, see Multiple Provider Instances.
last-updated: 2025-09-01
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/schematics?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Deploying resources in a specific region or across multiple regions
{: #multi-region-deployment}

IBM Cloud® Schematics enables you to deploy resources in any IBM Cloud location or region globally. The region where you save and execute your Schematics `workspaces` and `actions` is independent of the region where your Cloud resources are deployed or configured.

IBM Cloud Schematics executes your jobs from your selected Schematics region and remotely access the services to provision resources in the target regions determined by your Terraform templates. It is unaffected by network latency between regions. For example, If you create a workspace in `us-south`, you can use this workspace to provision services in any supported IBM Cloud region, such as `us-east` or `eu-gb`. The location of your workspace determines where your workspace data is stored and where your workspace requests are run. For more information, see [Where is the information stored?](https://cloud.ibm.com/docs/schematics?topic=schematics-secure-data&format=markdown#pi-location)

## Deploying services in a specific region
{: #single-region}

If all your services can be deployed to the same region, you can specify the region in the `provider` block of your Terraform template.

If no region is specified in the `provider` block, Schematics automatically attempts to create your Cloud resources in the `us-south` region.

1. Open the `provider.tf` file or the Terraform configuration file that contains the `provider` block.
2. Specify the region where you want to deploy your services. Make sure that the region that you enter is supported by the service that you want to deploy with Schematics.

    ```terraform
    provider "ibm" {
        region = "<region_name>"
    }

    ```
    {: codeblock}

3. Check if the service that you want to deploy requires a `location` parameter to be set in addition to the `region` parameter. For example, if you use the [`ibm_database`](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/database){: external} Terraform resource, you must set both the `region` parameter in the `provider` block and the `location` parameter in the `ibm_database` resource definition.

4. Follow the [steps](https://cloud.ibm.com/docs/schematics?topic=schematics-manage-lifecycle&format=markdown#deploy-resources) to deploy your Cloud resources.

## Deploying services across regions
{: #across-regions}

You can add multiple multiple provider configurations to the `provider` block to specify the regions where you want to deploy your Cloud resources. For more information, see [Multiple Provider Instances](https://developer.hashicorp.com/hcp){: external}.
{: shortdesc}

1. In the `provider` block of your Terraform configuration file or the `provider.tf` file, create multiple provider blocks with the same provider name. The provider configuration without an alias is considered the default provider configuration and is used for every resource where you do not specify a specific provider configuration. If you add more provider configurations, you must include an alias so that you can reference this provider from your resource definition in the Terraform configuration file. In the following example, the default provider configuration deploys resources in `us-south` while the provider configuration with the alias `east` deploys all resources in `us-east`.

    ```terraform
    provider "ibm" {
        region = "us-south"
    }

    provider "ibm" {
        alias = "east"
        region = "us-east"
    }
    ```
    {: codeblock}

2. In your resource definition of your Terraform configuration file, specify the provider configuration that you want to use. If you do not specify a provider, the default provider configuration is used.

    ```terraform
    resource "ibm_container_cluster" "cluster" {
        provider = ibm.east
    ...
    }

    resource ibm_is_vpc "vpc" {
        name = "myvpc"
    }
    ```
    {: codeblock}

3. Follow the [steps](https://cloud.ibm.com/docs/schematics?topic=schematics-manage-lifecycle&format=markdown#deploy-resources) to deploy your Cloud resources.