# Google Cloud Storage Backup

Google Cloud Storage Backup is a self-hosted backup app. A lightweight Docker container that backs up one or more local folders to Google Cloud Storage buckets using the gsutil command-line tool. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1805/google-cloud-storage-backup

## Description

A lightweight Docker container that backs up one or more local folders to Google Cloud Storage buckets using the gsutil command-line tool. Designed for home-server and homelab users who want scheduled, automated cloud backups without managing complex infrastructure.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

46/100 (Fair), based on 4 of 4 factors.
- Maintained: 79 (last commit 14 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/vinid223/gcloud-storage-backup
- GitHub: https://github.com/vinid223/GcloudStorage-docker
- Unraid: https://ca.unraid.net/apps/google-cloud-storage-backup-0tydr8q12iba52?q=google-cloud-storage-backup

## Common questions

### How do I choose which local folders this container backs up?

Mount your desired folders into the container under the /data directory. The container backs up everything placed under /data to the configured Google Cloud Storage bucket.

### How can I change the default hourly backup schedule?

Set the CRON_SCHEDULE environment variable using standard cron notation. The default value 0 * * * * runs the backup every hour.

### How do I make the bucket match my local folders and delete removed files?

Set GCSOPTIONS with custom gsutil parameters. For example, using -d makes the backup an exact copy and deletes bucket files that no longer exist locally.

### Can I provide GCP credentials with a mounted config file instead of environment variables?

Mount a user-generated Boto file containing gs_access_key_id and gs_secret_access_key, then set BOTO_FILE to that file path. This setting ignores ACCESS_KEY and SECRET_KEY.

### Where in Google Cloud do I get the HMAC key values for this container?

Go to the GCS Settings page and open the Interoperability tab. Under Service account HMAC, select or create a service account and create a key to get the access key and secret key.

---
Source: Our Local Host (https://ourlocalhost.com/app/1805/google-cloud-storage-backup), the self-hosted and open-source app directory.
