How can I select a different region for my cluster?

You can change regions in both AWS and GCP cloud provider backends.  Here, we'll illustrate how to do that with AWS.

Coiled will default to using the AWS us-east-1 region.  This might not be the best region for your purposes; perhaps you are closer to a different region, or you have data you would like to access that is already stored in a specific region.  

There are different ways that you can change your region.   For detailed information on this topic, see the relevant section of our docs (for AWS, or for GCP).

Changing Region When Instantiating a Cluster

Let’s assume that you have AWS (VM) as your cloud provider backend. By default (unless specified differently in your account - see below), when you spin up a cluster with Coiled, it will use the us-east-1 region. You can change this behaviour by passing the keyword argument backend_options to the coiled.Cluster constructor.

import coiled

cluster = coiled.Cluster(backend_options={"region": "us-east-2"})

This example will create a cluster in AWS us-east-2 region and use Coiled’s default cluster configuration.

Changing region on your Account

Let’s assume that you have all your data in us-east-1, and you will always want to use this region when creating clusters and running computations. We can save your desired region so you don’t have to use the keyword argument backend_options from the coiled.Cluster constructor all the time.

To change the region on your Account, head over to your account page on cloud.coiled.io, then in the Cloud Backend Options click the EDIT button and select a different region from the region dropdown menu.