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 a dedicated service account for PeerDB, with the Storage Object User role. After this, create a HMAC key-pair for the service account.

Creating SA for PeerDB

  1. 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.

Create peer drop down

  1. 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.

Create peer drop down

ClickHouse Setup GuideS3 Setup Guide