You are not reading the most current version of the documentation. If you want up-to-date information, please have a look at 2.5 .

Setup Google Cloud Storage

Create a bucket

Go to Google Cloud Storage and create a new bucket in a region where Scylla nodes are. If your cluster is deployed in multiple regions create a bucket per region. You may decide to backup only a single datacenter to save on costs, in that case create only one bucket in a region you want to backup.

Grant access

This procedure is required so that Scylla Manager can access your bucket.

Choose how you want to configure access to the bucket. If your application runs inside a Google Cloud environment we recommend using automatic Service account authentication. Otherwise you can add your credentials to the agent configuration file. The later method is less secure as you will be propagating each node with this security information and in cases where you need to change the key, you will have to replace it on each node.

Automatic service account authorization


  1. Collect list of service accounts used by each of the Scylla nodes.

  2. Make sure that each of service account has read/write access scope to Cloud Storage.

  3. For each service account from the list, add Storage Object Admin role in bucket permissions settings.

Config file

Use this instruction to get the service account file.

Note that this procedure needs to be repeated for each Scylla node.


Edit the /etc/scylla-manager-agent/scylla-manager-agent.yaml

  1. Uncomment the gcs: line, for parameters note the two spaces in front, it’s a yaml file.

  2. Uncomment and set service_account_file with the path to the service account credentials file.

  3. For each service account used by the nodes, add Storage Object Admin role in the bucket permissions settings.

  4. Validate that the manager has access to the backup location. If there is no response, the bucket is accessible. If not, you will see an error.

    scylla-manager-agent check-location --location gcs:<your GCS bucket name>

Troubleshoot connectivity

To troubleshoot Node to bucket connectivity issues you can run:

scylla-manager-agent check-location --debug --location gcs:<your GCS bucket name>