It’s quick and easy to get started using Coiled in your own Google Cloud account. This guide will cover the steps for getting started with Coiled using the command-line interface, all from your terminal.
Install the Coiled Python library with:
conda install -c conda-forge coiled-runtime python=3.9
pip install coiled-runtime
Log in to your Coiled account:
Set up IAM
If you would like to use the default options for network configuration and container registry, where Coiled creates a VPC in your account and uses Google Artifact Registry for storing your Python environments you can run:
coiled setup gcp
Otherwise, you can configure Coiled to use a custom network configuration (e.g. your pre-existing VPC) or a different container registry for your Python environment (e.g. Docker Hub):
coiled setup gcp --manual-final-setup
After which you will be provided with the required access key and prompted to complete configuration in the Coiled web app at
With your permission, this command will create the IAM roles and service accounts Coiled needs so you can create clusters in your GCP project. You will be prompted with an explanation at each step, so you can choose to say “yes” (or “no”) at any point (see Configuring GCP for more details).
Start your Dask cluster in the cloud (see Running your computation):
ipython > import coiled > cluster = coiled.Cluster(name="gcp-quickstart", n_workers=5)
If you don’t already an GCP account and have more questions, see Need a cloud provider account?