> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peerdb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GCS Setup Guide

1. Create a new Cloud Storage bucket or ensure an existing bucket is available for use.
2. We need to create an access key pair, for connecting to this bucket. This access key can be on a user account or on a service account. We recommend [creating](https://cloud.google.com/iam/docs/service-accounts-create) a dedicated service account for PeerDB, with the `Storage Object User` role. After this, [create a HMAC key-pair](https://cloud.google.com/storage/docs/authentication/managing-hmackeys) for the service account.

<Frame caption="Creating SA for PeerDB">
  <img src="https://mintcdn.com/peerdb/L54DxDXK99_p-wL9/images/setup/gcs_create_sa.png?fit=max&auto=format&n=L54DxDXK99_p-wL9&q=85&s=349c31e2c40a638f64f98408e1ced6db" width="1096" height="914" data-path="images/setup/gcs_create_sa.png" />
</Frame>

3. In the PeerDB UI, select the Peers menu and select the New Peer option on the top right. Select the peer type as S3 (GCS is very similar to S3 and in PeerDB they share the same menu) and click on continue.

<Frame caption="Create peer drop down">
  <img src="https://mintcdn.com/peerdb/wtgPI5cQwjI2FO0m/images/setup/s3_gcs_peer.png?fit=max&auto=format&n=wtgPI5cQwjI2FO0m&q=85&s=c8a9eea67952f1211619f3c9e1c733a2" width="1348" height="876" data-path="images/setup/s3_gcs_peer.png" />
</Frame>

4. Choose a peer name, and fill your bucket URL (with optional prefix, in case you want PeerDB's files to be nested within the bucket), access key and secret access key. Click `Validate` to see if any issues crop up and fix them accordingly. Then click Create peer to finish peer creation.

<Frame caption="Create peer drop down">
  <img src="https://mintcdn.com/peerdb/L54DxDXK99_p-wL9/images/setup/gcs_create_peer.png?fit=max&auto=format&n=L54DxDXK99_p-wL9&q=85&s=a3125040964b2a9956d76482833728a7" width="2082" height="1220" data-path="images/setup/gcs_create_peer.png" />
</Frame>
