Google Cloud Storage Setup

Connect your Google Cloud Storage bucket to Snipish using S3-compatible interoperability mode.

Prerequisites

• A Google Cloud account with a project
• Billing enabled on the project

Step 1: Create a Storage Bucket

1. Go to Cloud Storage → Create Bucket
2. Enter a globally unique name (e.g., snipish-screenshots-yourname)
3. Choose a location type and region
4. Select Standard storage class
5. Keep Uniform access control
6. Click Create

Step 2: Configure CORS

Create a file called cors.json and apply it using gsutil:

[
  {
    "origin": ["https://snipish.app"],
    "method": ["GET", "PUT", "HEAD"],
    "responseHeader": ["*"],
    "maxAgeSeconds": 3600
  }
]

gsutil cors set cors.json gs://snipish-screenshots-yourname

Step 3: Create HMAC Keys (S3-Compatible)

Snipish connects via the S3-compatible API. You need HMAC keys:

1. Go to Cloud Storage → Settings → Interoperability
2. Under Service account HMAC, click Create a key for a service account
3. Select or create a service account with Storage Object Admin role on your bucket
4. Copy the Access Key and Secret

Step 4: Configure in Snipish

1. Go to Settings → Storage in Snipish
2. Click Connect Your Own Bucket
3. Select Google Cloud Storage as the provider
4. Enter the Bucket Name
5. For the endpoint, use: https://storage.googleapis.com
6. Paste your Access Key and Secret
7. Click Validate & Connect

Step 5: Verify

Upload a test screenshot. Check your bucket in the Google Cloud console — the file should appear within seconds.

Troubleshooting

• Validation fails — Ensure the service account has the Storage Object Admin role on the specific bucket, not just the project.
• CORS errors in browser — Verify the CORS configuration was applied correctly using gsutil cors get gs://your-bucket.
• HMAC keys not available — Make sure interoperability access is enabled in the Cloud Storage settings.