Google Cloud Storage Backup
A lightweight Docker container that backs up one or more local folders to Google Cloud Storage buckets using the gsutil command-line tool.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
46/100 Fair
- Maintained
- 79last commit 14 days ago
- Popular
- 123 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 304 GB minimum RAM
Availability: platform listings confirmed today, links checked 37 days ago
- GitHub stars
- 3
- Open issues
- 0
- Last commit
- 2026-11-07
- License
- GPL-3.0
- Activity
- rising
Checked 10 days ago - source: GitHub (vinid223/GcloudStorage-docker)
Resources & Compatibility
Minimum requirements: 4 GB RAM. ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- GCP Service Account Credentials Create a Google Cloud Platform service account, then set the ACCESS_KEY and SECRET_KEY environment variables at container launch. The access key string must not contain the pipe (|) character. source
Fetched 45 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from github.com
Community
- Cloud Storage: Who Did You Go With for Your Backups? - Reddit (reddit)
- google-cloud-storage-discuss - Google Groups (other)
- Google Cloud Storage - Google Groups (other)
- Google Cloud Developers - Google Groups (other)
Collected 48 days ago - public community threads