Google Cloud Storage

<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> <meta name="description" content="Rclone docs for Google Cloud Storage"> <meta name="author" content="Nick Craig-Wood"> <link rel="shortcut icon" type="image/png" href="/img/rclone-32x32.png"/> <script defer data-domain="rclone.org" src="https://weblog.rclone.org/js/script.js"></script> <title>Google Cloud Storage</title> <link rel="canonical" href="https://rclone.org/googlecloudstorage/"> <link href="/css/bootstrap.min.4.4.1.css" rel="stylesheet"> <link href="/css/font-awesome.min.5.10.2.css" rel="stylesheet"> <link href="/css/custom.css?r=-62135596800" rel="stylesheet"> </head> <body> <nav class="navbar navbar-expand-md navbar-dark bg-dark"> <a class="navbar-brand" href="/"><img class="rclone-logo" src="/img/logo_on_dark__horizontal_color.svg" alt="rclone logo"></a> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarSupportedContent"> <ul class="navbar-nav mr-auto"> <li class="nav-item active"> <a class="nav-link" href="/downloads/">Downloads</a> </li> <li class="nav-item active dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Docs </a> <div class="dropdown-menu" aria-labelledby="navbarDropdown"> <a class="dropdown-item" href="/install/"><i class="fa fa-book fa-fw"></i> Installation</a> <a class="dropdown-item" href="/docs/"><i class="fa fa-book fa-fw"></i> Usage</a> <a class="dropdown-item" href="/filtering/"><i class="fa fa-book fa-fw"></i> Filtering</a> <a class="dropdown-item" href="/gui/"><i class="fa fa-book fa-fw"></i> GUI</a> <a class="dropdown-item" href="/rc/"><i class="fa fa-book fa-fw"></i> Remote Control</a> <a class="dropdown-item" href="/changelog/"><i class="fa fa-book fa-fw"></i> Changelog</a> <a class="dropdown-item" href="/bugs/"><i class="fa fa-book fa-fw"></i> Bugs</a> <a class="dropdown-item" href="/faq/"><i class="fa fa-book fa-fw"></i> FAQ</a> <a class="dropdown-item" href="/flags/"><i class="fa fa-book fa-fw"></i> Flags</a> <a class="dropdown-item" href="/licence/"><i class="fa fa-book fa-fw"></i> Licence</a> <a class="dropdown-item" href="/authors/"><i class="fa fa-book fa-fw"></i> Authors</a> <a class="dropdown-item" href="/privacy/"><i class="fa fa-book fa-fw"></i> Privacy Policy</a> </div> </li> <li class="nav-item active dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Commands </a> <div class="dropdown-menu pre-scrollable" aria-labelledby="navbarDropdown"> <a class="dropdown-item" href="/commands/"><i class="fas fa-map fa-fw"></i> Overview</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/commands/rclone/"><i class="fa fa-book fa-fw"></i> rclone</a> <a class="dropdown-item" href="/commands/rclone_about/"><i class="fa fa-book fa-fw"></i> rclone about</a> <a class="dropdown-item" href="/commands/rclone_authorize/"><i class="fa fa-book fa-fw"></i> rclone authorize</a> <a class="dropdown-item" href="/commands/rclone_backend/"><i class="fa fa-book fa-fw"></i> rclone backend</a> <a class="dropdown-item" href="/commands/rclone_bisync/"><i class="fa fa-book fa-fw"></i> rclone bisync</a> <a class="dropdown-item" href="/commands/rclone_cat/"><i class="fa fa-book fa-fw"></i> rclone cat</a> <a class="dropdown-item" href="/commands/rclone_check/"><i class="fa fa-book fa-fw"></i> rclone check</a> <a class="dropdown-item" href="/commands/rclone_checksum/"><i class="fa fa-book fa-fw"></i> rclone checksum</a> <a class="dropdown-item" href="/commands/rclone_cleanup/"><i class="fa fa-book fa-fw"></i> rclone cleanup</a> <a class="dropdown-item" href="/commands/rclone_completion/"><i class="fa fa-book fa-fw"></i> rclone completion</a> <a class="dropdown-item" href="/commands/rclone_config/"><i class="fa fa-book fa-fw"></i> rclone config</a> <a class="dropdown-item" href="/commands/rclone_copy/"><i class="fa fa-book fa-fw"></i> rclone copy</a> <a class="dropdown-item" href="/commands/rclone_copyto/"><i class="fa fa-book fa-fw"></i> rclone copyto</a> <a class="dropdown-item" href="/commands/rclone_copyurl/"><i class="fa fa-book fa-fw"></i> rclone copyurl</a> <a class="dropdown-item" href="/commands/rclone_cryptcheck/"><i class="fa fa-book fa-fw"></i> rclone cryptcheck</a> <a class="dropdown-item" href="/commands/rclone_cryptdecode/"><i class="fa fa-book fa-fw"></i> rclone cryptdecode</a> <a class="dropdown-item" href="/commands/rclone_dedupe/"><i class="fa fa-book fa-fw"></i> rclone dedupe</a> <a class="dropdown-item" href="/commands/rclone_delete/"><i class="fa fa-book fa-fw"></i> rclone delete</a> <a class="dropdown-item" href="/commands/rclone_deletefile/"><i class="fa fa-book fa-fw"></i> rclone deletefile</a> <a class="dropdown-item" href="/commands/rclone_gendocs/"><i class="fa fa-book fa-fw"></i> rclone gendocs</a> <a class="dropdown-item" href="/commands/rclone_gitannex/"><i class="fa fa-book fa-fw"></i> rclone gitannex</a> <a class="dropdown-item" href="/commands/rclone_hashsum/"><i class="fa fa-book fa-fw"></i> rclone hashsum</a> <a class="dropdown-item" href="/commands/rclone_link/"><i class="fa fa-book fa-fw"></i> rclone link</a> <a class="dropdown-item" href="/commands/rclone_listremotes/"><i class="fa fa-book fa-fw"></i> rclone listremotes</a> <a class="dropdown-item" href="/commands/rclone_ls/"><i class="fa fa-book fa-fw"></i> rclone ls</a> <a class="dropdown-item" href="/commands/rclone_lsd/"><i class="fa fa-book fa-fw"></i> rclone lsd</a> <a class="dropdown-item" href="/commands/rclone_lsf/"><i class="fa fa-book fa-fw"></i> rclone lsf</a> <a class="dropdown-item" href="/commands/rclone_lsjson/"><i class="fa fa-book fa-fw"></i> rclone lsjson</a> <a class="dropdown-item" href="/commands/rclone_lsl/"><i class="fa fa-book fa-fw"></i> rclone lsl</a> <a class="dropdown-item" href="/commands/rclone_md5sum/"><i class="fa fa-book fa-fw"></i> rclone md5sum</a> <a class="dropdown-item" href="/commands/rclone_mkdir/"><i class="fa fa-book fa-fw"></i> rclone mkdir</a> <a class="dropdown-item" href="/commands/rclone_mount/"><i class="fa fa-book fa-fw"></i> rclone mount</a> <a class="dropdown-item" href="/commands/rclone_move/"><i class="fa fa-book fa-fw"></i> rclone move</a> <a class="dropdown-item" href="/commands/rclone_moveto/"><i class="fa fa-book fa-fw"></i> rclone moveto</a> <a class="dropdown-item" href="/commands/rclone_ncdu/"><i class="fa fa-book fa-fw"></i> rclone ncdu</a> <a class="dropdown-item" href="/commands/rclone_nfsmount/"><i class="fa fa-book fa-fw"></i> rclone nfsmount</a> <a class="dropdown-item" href="/commands/rclone_obscure/"><i class="fa fa-book fa-fw"></i> rclone obscure</a> <a class="dropdown-item" href="/commands/rclone_purge/"><i class="fa fa-book fa-fw"></i> rclone purge</a> <a class="dropdown-item" href="/commands/rclone_rc/"><i class="fa fa-book fa-fw"></i> rclone rc</a> <a class="dropdown-item" href="/commands/rclone_rcat/"><i class="fa fa-book fa-fw"></i> rclone rcat</a> <a class="dropdown-item" href="/commands/rclone_rcd/"><i class="fa fa-book fa-fw"></i> rclone rcd</a> <a class="dropdown-item" href="/commands/rclone_rmdir/"><i class="fa fa-book fa-fw"></i> rclone rmdir</a> <a class="dropdown-item" href="/commands/rclone_rmdirs/"><i class="fa fa-book fa-fw"></i> rclone rmdirs</a> <a class="dropdown-item" href="/commands/rclone_selfupdate/"><i class="fa fa-book fa-fw"></i> rclone selfupdate</a> <a class="dropdown-item" href="/commands/rclone_serve/"><i class="fa fa-book fa-fw"></i> rclone serve</a> <a class="dropdown-item" href="/commands/rclone_settier/"><i class="fa fa-book fa-fw"></i> rclone settier</a> <a class="dropdown-item" href="/commands/rclone_sha1sum/"><i class="fa fa-book fa-fw"></i> rclone sha1sum</a> <a class="dropdown-item" href="/commands/rclone_size/"><i class="fa fa-book fa-fw"></i> rclone size</a> <a class="dropdown-item" href="/commands/rclone_sync/"><i class="fa fa-book fa-fw"></i> rclone sync</a> <a class="dropdown-item" href="/commands/rclone_test/"><i class="fa fa-book fa-fw"></i> rclone test</a> <a class="dropdown-item" href="/commands/rclone_touch/"><i class="fa fa-book fa-fw"></i> rclone touch</a> <a class="dropdown-item" href="/commands/rclone_tree/"><i class="fa fa-book fa-fw"></i> rclone tree</a> <a class="dropdown-item" href="/commands/rclone_version/"><i class="fa fa-book fa-fw"></i> rclone version</a> </div> </li> <li class="nav-item active dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Storage Systems </a> <div class="dropdown-menu pre-scrollable" aria-labelledby="navbarDropdown"> <a class="dropdown-item" href="/overview/"><i class="fas fa-map fa-fw"></i> Overview</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/fichier/"><i class="fa fa-archive fa-fw"></i> 1Fichier</a> <a class="dropdown-item" href="/netstorage/"><i class="fas fa-database fa-fw"></i> Akamai NetStorage</a> <a class="dropdown-item" href="/alias/"><i class="fa fa-link fa-fw"></i> Alias</a> <a class="dropdown-item" href="/s3/"><i class="fab fa-amazon fa-fw"></i> Amazon S3</a> <a class="dropdown-item" href="/b2/"><i class="fa fa-fire fa-fw"></i> Backblaze B2</a> <a class="dropdown-item" href="/box/"><i class="fa fa-archive fa-fw"></i> Box</a> <a class="dropdown-item" href="/chunker/"><i class="fa fa-cut fa-fw"></i> Chunker (splits large files)</a> <a class="dropdown-item" href="/compress/"><i class="fas fa-compress fa-fw"></i> Compress (transparent gzip compression)</a> <a class="dropdown-item" href="/combine/"><i class="fa fa-folder-plus fa-fw"></i> Combine (remotes into a directory tree)</a> <a class="dropdown-item" href="/sharefile/"><i class="fas fa-share-square fa-fw"></i> Citrix ShareFile</a> <a class="dropdown-item" href="/crypt/"><i class="fa fa-lock fa-fw"></i> Crypt (encrypts the others)</a> <a class="dropdown-item" href="/koofr/#digi-storage"><i class="fa fa-cloud fa-fw"></i> Digi Storage</a> <a class="dropdown-item" href="/dropbox/"><i class="fab fa-dropbox fa-fw"></i> Dropbox</a> <a class="dropdown-item" href="/filefabric/"><i class="fa fa-cloud fa-fw"></i> Enterprise File Fabric</a> <a class="dropdown-item" href="/filescom/"><i class="fa fa-file-alt fa-fw"></i> Files.com</a> <a class="dropdown-item" href="/ftp/"><i class="fa fa-file fa-fw"></i> FTP</a> <a class="dropdown-item" href="/gofile/"><i class="fa fa-folder fa-fw"></i> Gofile</a> <a class="dropdown-item" href="/googlecloudstorage/"><i class="fab fa-google fa-fw"></i> Google Cloud Storage</a> <a class="dropdown-item" href="/drive/"><i class="fab fa-google fa-fw"></i> Google Drive</a> <a class="dropdown-item" href="/googlephotos/"><i class="fas fa-images fa-fw"></i> Google Photos</a> <a class="dropdown-item" href="/hasher/"><i class="fa fa-check-double fa-fw"></i> Hasher (better checksums for others)</a> <a class="dropdown-item" href="/hdfs/"><i class="fa fa-globe fa-fw"></i> HDFS (Hadoop Distributed Filesystem)</a> <a class="dropdown-item" href="/hidrive/"><i class="fa fa-cloud fa-fw"></i> HiDrive</a> <a class="dropdown-item" href="/http/"><i class="fa fa-globe fa-fw"></i> HTTP</a> <a class="dropdown-item" href="/imagekit/"><i class="fa fa-cloud fa-fw"></i> ImageKit</a> <a class="dropdown-item" href="/internetarchive/"><i class="fa fa-archive fa-fw"></i> Internet Archive</a> <a class="dropdown-item" href="/jottacloud/"><i class="fa fa-cloud fa-fw"></i> Jottacloud</a> <a class="dropdown-item" href="/koofr/"><i class="fa fa-suitcase fa-fw"></i> Koofr</a> <a class="dropdown-item" href="/linkbox/"><i class="fa fa-infinity fa-fw"></i> Linkbox</a> <a class="dropdown-item" href="/mailru/"><i class="fa fa-at fa-fw"></i> Mail.ru Cloud</a> <a class="dropdown-item" href="/mega/"><i class="fa fa-archive fa-fw"></i> Mega</a> <a class="dropdown-item" href="/memory/"><i class="fas fa-memory fa-fw"></i> Memory</a> <a class="dropdown-item" href="/azureblob/"><i class="fab fa-windows fa-fw"></i> Microsoft Azure Blob Storage</a> <a class="dropdown-item" href="/azurefiles/"><i class="fab fa-windows fa-fw"></i> Microsoft Azure Files Storage</a> <a class="dropdown-item" href="/onedrive/"><i class="fab fa-windows fa-fw"></i> Microsoft OneDrive</a> <a class="dropdown-item" href="/opendrive/"><i class="fa fa-space-shuttle fa-fw"></i> OpenDrive</a> <a class="dropdown-item" href="/qingstor/"><i class="fas fa-hdd fa-fw"></i> QingStor</a> <a class="dropdown-item" href="/swift/"><i class="fa fa-space-shuttle fa-fw"></i> Openstack Swift</a> <a class="dropdown-item" href="/oracleobjectstorage/"><i class="fa fa-cloud fa-fw"></i> Oracle Object Storage</a> <a class="dropdown-item" href="/pcloud/"><i class="fa fa-cloud fa-fw"></i> pCloud</a> <a class="dropdown-item" href="/pikpak/"><i class="fa fa-cloud fa-fw"></i> PikPak</a> <a class="dropdown-item" href="/pixeldrain/"><i class="fa fa-circle fa-fw"></i> Pixeldrain</a> <a class="dropdown-item" href="/premiumizeme/"><i class="fa fa-user fa-fw"></i> premiumize.me</a> <a class="dropdown-item" href="/putio/"><i class="fas fa-parking fa-fw"></i> put.io</a> <a class="dropdown-item" href="/protondrive/"><i class="fas fa-folder fa-fw"></i> Proton Drive</a> <a class="dropdown-item" href="/quatrix/"><i class="fas fa-shield-alt fa-fw"></i> Quatrix</a> <a class="dropdown-item" href="/seafile/"><i class="fa fa-server fa-fw"></i> Seafile</a> <a class="dropdown-item" href="/sftp/"><i class="fa fa-server fa-fw"></i> SFTP</a> <a class="dropdown-item" href="/sia/"><i class="fa fa-globe fa-fw"></i> Sia</a> <a class="dropdown-item" href="/smb/"><i class="fa fa-server fa-fw"></i> SMB / CIFS</a> <a class="dropdown-item" href="/storj/"><i class="fas fa-dove fa-fw"></i> Storj</a> <a class="dropdown-item" href="/sugarsync/"><i class="fas fa-dove fa-fw"></i> SugarSync</a> <a class="dropdown-item" href="/ulozto/"><i class="fas fa-angle-double-down fa-fw"></i> Uloz.to</a> <a class="dropdown-item" href="/uptobox/"><i class="fa fa-archive fa-fw"></i> Uptobox</a> <a class="dropdown-item" href="/union/"><i class="fa fa-link fa-fw"></i> Union (merge backends)</a> <a class="dropdown-item" href="/webdav/"><i class="fa fa-server fa-fw"></i> WebDAV</a> <a class="dropdown-item" href="/yandex/"><i class="fa fa-space-shuttle fa-fw"></i> Yandex Disk</a> <a class="dropdown-item" href="/zoho/"><i class="fas fa-folder fa-fw"></i> Zoho WorkDrive</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/local/"><i class="fas fa-hdd fa-fw"></i> The local filesystem</a> </div> </li> <li class="nav-item active"> <a class="nav-link" href="/contact/"><i class="fa fa-envelope fa-fw"></i> Contact</a> </li> <li class="nav-item active"> <a class="nav-link" href="/sponsor/"><i class="fa fa-heart heart fa-fw"></i> Sponsor</a> </li> </ul> <ul class="navbar-nav mr-auto"> <li class="nav-item active"> <a href="https://rclone.com/" target="_blank" class="nav-link bizbutton" title="Click here for support and advertising contracts"><i class="fa fa-briefcase"></i> For Business</a> </li> </ul> <form class="form-inline" name="search_form" action="https://google.com/search" target="_blank" onsubmit="on_search();"> <input name="words" value="" type="search" placeholder="search..." class="form-control form-control-sm"> <input name="q" value="" type="hidden"> <input name="as_sitesearch" value="https://rclone.org/" type="hidden"> </form> </div> </nav> <div class="container-fluid"> <div class="row"> <div class="col-md-9"> <span class="badge badge-pill badge-secondary float-right" style="margin-top: 30px; font-size: 100%" title="This feature needs Rclone v1.02 or later.">v1.02</span> <h1 id="hahahugoshortcode31s0hbhb-google-cloud-storage"><i class="fab fa-google" aria-hidden="true"></i> Google Cloud Storage</h1> <p>Paths are specified as <code>remote:bucket</code> (or <code>remote:</code> for the <code>lsd</code> command.) You may put subdirectories in too, e.g. <code>remote:bucket/path/to/dir</code>.</p> <h2 id="configuration">Configuration</h2> <p>The initial setup for google cloud storage involves getting a token from Google Cloud Storage which you need to do in your browser. <code>rclone config</code> walks you through it.</p> <p>Here is an example of how to make a remote called <code>remote</code>. First run:</p> <pre><code> rclone config </code></pre> <p>This will guide you through an interactive setup process:</p> <pre tabindex="0"><code>n) New remote d) Delete remote q) Quit config e/n/d/q> n name> remote Type of storage to configure. Choose a number from below, or type in your own value [snip] XX / Google Cloud Storage (this is not Google Drive) \ "google cloud storage" [snip] Storage> google cloud storage Google Application Client Id - leave blank normally. client_id> Google Application Client Secret - leave blank normally. client_secret> Project number optional - needed only for list/create/delete buckets - see your developer console. project_number> 12345678 Service Account Credentials JSON file path - needed only if you want use SA instead of interactive login. service_account_file> Access Control List for new objects. Choose a number from below, or type in your own value 1 / Object owner gets OWNER access, and all Authenticated Users get READER access. \ "authenticatedRead" 2 / Object owner gets OWNER access, and project team owners get OWNER access. \ "bucketOwnerFullControl" 3 / Object owner gets OWNER access, and project team owners get READER access. \ "bucketOwnerRead" 4 / Object owner gets OWNER access [default if left blank]. \ "private" 5 / Object owner gets OWNER access, and project team members get access according to their roles. \ "projectPrivate" 6 / Object owner gets OWNER access, and all Users get READER access. \ "publicRead" object_acl> 4 Access Control List for new buckets. Choose a number from below, or type in your own value 1 / Project team owners get OWNER access, and all Authenticated Users get READER access. \ "authenticatedRead" 2 / Project team owners get OWNER access [default if left blank]. \ "private" 3 / Project team members get access according to their roles. \ "projectPrivate" 4 / Project team owners get OWNER access, and all Users get READER access. \ "publicRead" 5 / Project team owners get OWNER access, and all Users get WRITER access. \ "publicReadWrite" bucket_acl> 2 Location for the newly created buckets. Choose a number from below, or type in your own value 1 / Empty for default location (US). \ "" 2 / Multi-regional location for Asia. \ "asia" 3 / Multi-regional location for Europe. \ "eu" 4 / Multi-regional location for United States. \ "us" 5 / Taiwan. \ "asia-east1" 6 / Tokyo. \ "asia-northeast1" 7 / Singapore. \ "asia-southeast1" 8 / Sydney. \ "australia-southeast1" 9 / Belgium. \ "europe-west1" 10 / London. \ "europe-west2" 11 / Iowa. \ "us-central1" 12 / South Carolina. \ "us-east1" 13 / Northern Virginia. \ "us-east4" 14 / Oregon. \ "us-west1" location> 12 The storage class to use when storing objects in Google Cloud Storage. Choose a number from below, or type in your own value 1 / Default \ "" 2 / Multi-regional storage class \ "MULTI_REGIONAL" 3 / Regional storage class \ "REGIONAL" 4 / Nearline storage class \ "NEARLINE" 5 / Coldline storage class \ "COLDLINE" 6 / Durable reduced availability storage class \ "DURABLE_REDUCED_AVAILABILITY" storage_class> 5 Remote config Use web browser to automatically authenticate rclone with remote? * Say Y if the machine running rclone has a web browser you can use * Say N if running rclone on a (remote) machine without web browser access If not sure try Y. If Y failed, try N. y) Yes n) No y/n> y If your browser doesn't open automatically go to the following link: http://127.0.0.1:53682/auth Log in and authorize rclone for access Waiting for code... Got code Configuration complete. Options: - type: google cloud storage - client_id: - client_secret: - token: {"AccessToken":"xxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","RefreshToken":"x/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxx","Expiry":"2014-07-17T20:49:14.929208288+01:00","Extra":null} - project_number: 12345678 - object_acl: private - bucket_acl: private Keep this "remote" remote? y) Yes this is OK e) Edit this remote d) Delete this remote y/e/d> y </code></pre><p>See the <a href="/remote_setup/">remote setup docs</a> for how to set it up on a machine with no Internet browser available.</p> <p>Note that rclone runs a webserver on your local machine to collect the token as returned from Google if using web browser to automatically authenticate. This only runs from the moment it opens your browser to the moment you get back the verification code. This is on <code>http://127.0.0.1:53682/</code> and this it may require you to unblock it temporarily if you are running a host firewall, or use manual mode.</p> <p>This remote is called <code>remote</code> and can now be used like this</p> <p>See all the buckets in your project</p> <pre><code>rclone lsd remote: </code></pre> <p>Make a new bucket</p> <pre><code>rclone mkdir remote:bucket </code></pre> <p>List the contents of a bucket</p> <pre><code>rclone ls remote:bucket </code></pre> <p>Sync <code>/home/local/directory</code> to the remote bucket, deleting any excess files in the bucket.</p> <pre><code>rclone sync --interactive /home/local/directory remote:bucket </code></pre> <h3 id="service-account-support">Service Account support</h3> <p>You can set up rclone with Google Cloud Storage in an unattended mode, i.e. not tied to a specific end-user Google account. This is useful when you want to synchronise files onto machines that don't have actively logged-in users, for example build machines.</p> <p>To get credentials for Google Cloud Platform <a href="https://cloud.google.com/iam/docs/service-accounts">IAM Service Accounts</a>, please head to the <a href="https://console.cloud.google.com/permissions/serviceaccounts">Service Account</a> section of the Google Developer Console. Service Accounts behave just like normal <code>User</code> permissions in <a href="https://cloud.google.com/storage/docs/access-control">Google Cloud Storage ACLs</a>, so you can limit their access (e.g. make them read only). After creating an account, a JSON file containing the Service Account's credentials will be downloaded onto your machines. These credentials are what rclone will use for authentication.</p> <p>To use a Service Account instead of OAuth2 token flow, enter the path to your Service Account credentials at the <code>service_account_file</code> prompt and rclone won't use the browser based authentication flow. If you'd rather stuff the contents of the credentials file into the rclone config file, you can set <code>service_account_credentials</code> with the actual contents of the file instead, or set the equivalent environment variable.</p> <h3 id="anonymous-access">Anonymous Access</h3> <p>For downloads of objects that permit public access you can configure rclone to use anonymous access by setting <code>anonymous</code> to <code>true</code>. With unauthorized access you can't write or create files but only read or list those buckets and objects that have public read access.</p> <h3 id="application-default-credentials">Application Default Credentials</h3> <p>If no other source of credentials is provided, rclone will fall back to <a href="https://cloud.google.com/video-intelligence/docs/common/auth#authenticating_with_application_default_credentials">Application Default Credentials</a> this is useful both when you already have configured authentication for your developer account, or in production when running on a google compute host. Note that if running in docker, you may need to run additional commands on your google compute machine - <a href="https://cloud.google.com/container-registry/docs/advanced-authentication#gcloud_as_a_docker_credential_helper">see this page</a>.</p> <p>Note that in the case application default credentials are used, there is no need to explicitly configure a project number.</p> <h3 id="fast-list">--fast-list</h3> <p>This remote supports <code>--fast-list</code> which allows you to use fewer transactions in exchange for more memory. See the <a href="/docs/#fast-list">rclone docs</a> for more details.</p> <h3 id="custom-upload-headers">Custom upload headers</h3> <p>You can set custom upload headers with the <code>--header-upload</code> flag. Google Cloud Storage supports the headers as described in the <a href="https://cloud.google.com/storage/docs/gsutil/addlhelp/WorkingWithObjectMetadata">working with metadata documentation</a></p> <ul> <li>Cache-Control</li> <li>Content-Disposition</li> <li>Content-Encoding</li> <li>Content-Language</li> <li>Content-Type</li> <li>X-Goog-Storage-Class</li> <li>X-Goog-Meta-</li> </ul> <p>Eg <code>--header-upload "Content-Type text/potato"</code></p> <p>Note that the last of these is for setting custom metadata in the form <code>--header-upload "x-goog-meta-key: value"</code></p> <h3 id="modification-times">Modification times</h3> <p>Google Cloud Storage stores md5sum natively. Google's <a href="https://cloud.google.com/storage/docs/gsutil">gsutil</a> tool stores modification time with one-second precision as <code>goog-reserved-file-mtime</code> in file metadata.</p> <p>To ensure compatibility with gsutil, rclone stores modification time in 2 separate metadata entries. <code>mtime</code> uses RFC3339 format with one-nanosecond precision. <code>goog-reserved-file-mtime</code> uses Unix timestamp format with one-second precision. To get modification time from object metadata, rclone reads the metadata in the following order: <code>mtime</code>, <code>goog-reserved-file-mtime</code>, object updated time.</p> <p>Note that rclone's default modify window is 1ns. Files uploaded by gsutil only contain timestamps with one-second precision. If you use rclone to sync files previously uploaded by gsutil, rclone will attempt to update modification time for all these files. To avoid these possibly unnecessary updates, use <code>--modify-window 1s</code>.</p> <h3 id="restricted-filename-characters">Restricted filename characters</h3> <table> <thead> <tr> <th>Character</th> <th style="text-align:center">Value</th> <th style="text-align:center">Replacement</th> </tr> </thead> <tbody> <tr> <td>NUL</td> <td style="text-align:center">0x00</td> <td style="text-align:center">␀</td> </tr> <tr> <td>LF</td> <td style="text-align:center">0x0A</td> <td style="text-align:center">␊</td> </tr> <tr> <td>CR</td> <td style="text-align:center">0x0D</td> <td style="text-align:center">␍</td> </tr> <tr> <td>/</td> <td style="text-align:center">0x2F</td> <td style="text-align:center">／</td> </tr> </tbody> </table> <p>Invalid UTF-8 bytes will also be <a href="/overview/#invalid-utf8">replaced</a>, as they can't be used in JSON strings.</p> <h3 id="standard-options">Standard options</h3> <p>Here are the Standard options specific to google cloud storage (Google Cloud Storage (this is not Google Drive)).</p> <h4 id="gcs-client-id">--gcs-client-id</h4> <p>OAuth Client Id.</p> <p>Leave blank normally.</p> <p>Properties:</p> <ul> <li>Config: client_id</li> <li>Env Var: RCLONE_GCS_CLIENT_ID</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-client-secret">--gcs-client-secret</h4> <p>OAuth Client Secret.</p> <p>Leave blank normally.</p> <p>Properties:</p> <ul> <li>Config: client_secret</li> <li>Env Var: RCLONE_GCS_CLIENT_SECRET</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-project-number">--gcs-project-number</h4> <p>Project number.</p> <p>Optional - needed only for list/create/delete buckets - see your developer console.</p> <p>Properties:</p> <ul> <li>Config: project_number</li> <li>Env Var: RCLONE_GCS_PROJECT_NUMBER</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-user-project">--gcs-user-project</h4> <p>User project.</p> <p>Optional - needed only for requester pays.</p> <p>Properties:</p> <ul> <li>Config: user_project</li> <li>Env Var: RCLONE_GCS_USER_PROJECT</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-service-account-file">--gcs-service-account-file</h4> <p>Service Account Credentials JSON file path.</p> <p>Leave blank normally. Needed only if you want use SA instead of interactive login.</p> <p>Leading <code>~</code> will be expanded in the file name as will environment variables such as <code>${RCLONE_CONFIG_DIR}</code>.</p> <p>Properties:</p> <ul> <li>Config: service_account_file</li> <li>Env Var: RCLONE_GCS_SERVICE_ACCOUNT_FILE</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-service-account-credentials">--gcs-service-account-credentials</h4> <p>Service Account Credentials JSON blob.</p> <p>Leave blank normally. Needed only if you want use SA instead of interactive login.</p> <p>Properties:</p> <ul> <li>Config: service_account_credentials</li> <li>Env Var: RCLONE_GCS_SERVICE_ACCOUNT_CREDENTIALS</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-anonymous">--gcs-anonymous</h4> <p>Access public buckets and objects without credentials.</p> <p>Set to 'true' if you just want to download files and don't configure credentials.</p> <p>Properties:</p> <ul> <li>Config: anonymous</li> <li>Env Var: RCLONE_GCS_ANONYMOUS</li> <li>Type: bool</li> <li>Default: false</li> </ul> <h4 id="gcs-object-acl">--gcs-object-acl</h4> <p>Access Control List for new objects.</p> <p>Properties:</p> <ul> <li>Config: object_acl</li> <li>Env Var: RCLONE_GCS_OBJECT_ACL</li> <li>Type: string</li> <li>Required: false</li> <li>Examples: <ul> <li>"authenticatedRead" <ul> <li>Object owner gets OWNER access.</li> <li>All Authenticated Users get READER access.</li> </ul> </li> <li>"bucketOwnerFullControl" <ul> <li>Object owner gets OWNER access.</li> <li>Project team owners get OWNER access.</li> </ul> </li> <li>"bucketOwnerRead" <ul> <li>Object owner gets OWNER access.</li> <li>Project team owners get READER access.</li> </ul> </li> <li>"private" <ul> <li>Object owner gets OWNER access.</li> <li>Default if left blank.</li> </ul> </li> <li>"projectPrivate" <ul> <li>Object owner gets OWNER access.</li> <li>Project team members get access according to their roles.</li> </ul> </li> <li>"publicRead" <ul> <li>Object owner gets OWNER access.</li> <li>All Users get READER access.</li> </ul> </li> </ul> </li> </ul> <h4 id="gcs-bucket-acl">--gcs-bucket-acl</h4> <p>Access Control List for new buckets.</p> <p>Properties:</p> <ul> <li>Config: bucket_acl</li> <li>Env Var: RCLONE_GCS_BUCKET_ACL</li> <li>Type: string</li> <li>Required: false</li> <li>Examples: <ul> <li>"authenticatedRead" <ul> <li>Project team owners get OWNER access.</li> <li>All Authenticated Users get READER access.</li> </ul> </li> <li>"private" <ul> <li>Project team owners get OWNER access.</li> <li>Default if left blank.</li> </ul> </li> <li>"projectPrivate" <ul> <li>Project team members get access according to their roles.</li> </ul> </li> <li>"publicRead" <ul> <li>Project team owners get OWNER access.</li> <li>All Users get READER access.</li> </ul> </li> <li>"publicReadWrite" <ul> <li>Project team owners get OWNER access.</li> <li>All Users get WRITER access.</li> </ul> </li> </ul> </li> </ul> <h4 id="gcs-bucket-policy-only">--gcs-bucket-policy-only</h4> <p>Access checks should use bucket-level IAM policies.</p> <p>If you want to upload objects to a bucket with Bucket Policy Only set then you will need to set this.</p> <p>When it is set, rclone:</p> <ul> <li>ignores ACLs set on buckets</li> <li>ignores ACLs set on objects</li> <li>creates buckets with Bucket Policy Only set</li> </ul> <p>Docs: <a href="https://cloud.google.com/storage/docs/bucket-policy-only">https://cloud.google.com/storage/docs/bucket-policy-only</a></p> <p>Properties:</p> <ul> <li>Config: bucket_policy_only</li> <li>Env Var: RCLONE_GCS_BUCKET_POLICY_ONLY</li> <li>Type: bool</li> <li>Default: false</li> </ul> <h4 id="gcs-location">--gcs-location</h4> <p>Location for the newly created buckets.</p> <p>Properties:</p> <ul> <li>Config: location</li> <li>Env Var: RCLONE_GCS_LOCATION</li> <li>Type: string</li> <li>Required: false</li> <li>Examples: <ul> <li>"" <ul> <li>Empty for default location (US)</li> </ul> </li> <li>"asia" <ul> <li>Multi-regional location for Asia</li> </ul> </li> <li>"eu" <ul> <li>Multi-regional location for Europe</li> </ul> </li> <li>"us" <ul> <li>Multi-regional location for United States</li> </ul> </li> <li>"asia-east1" <ul> <li>Taiwan</li> </ul> </li> <li>"asia-east2" <ul> <li>Hong Kong</li> </ul> </li> <li>"asia-northeast1" <ul> <li>Tokyo</li> </ul> </li> <li>"asia-northeast2" <ul> <li>Osaka</li> </ul> </li> <li>"asia-northeast3" <ul> <li>Seoul</li> </ul> </li> <li>"asia-south1" <ul> <li>Mumbai</li> </ul> </li> <li>"asia-south2" <ul> <li>Delhi</li> </ul> </li> <li>"asia-southeast1" <ul> <li>Singapore</li> </ul> </li> <li>"asia-southeast2" <ul> <li>Jakarta</li> </ul> </li> <li>"australia-southeast1" <ul> <li>Sydney</li> </ul> </li> <li>"australia-southeast2" <ul> <li>Melbourne</li> </ul> </li> <li>"europe-north1" <ul> <li>Finland</li> </ul> </li> <li>"europe-west1" <ul> <li>Belgium</li> </ul> </li> <li>"europe-west2" <ul> <li>London</li> </ul> </li> <li>"europe-west3" <ul> <li>Frankfurt</li> </ul> </li> <li>"europe-west4" <ul> <li>Netherlands</li> </ul> </li> <li>"europe-west6" <ul> <li>Zürich</li> </ul> </li> <li>"europe-central2" <ul> <li>Warsaw</li> </ul> </li> <li>"us-central1" <ul> <li>Iowa</li> </ul> </li> <li>"us-east1" <ul> <li>South Carolina</li> </ul> </li> <li>"us-east4" <ul> <li>Northern Virginia</li> </ul> </li> <li>"us-west1" <ul> <li>Oregon</li> </ul> </li> <li>"us-west2" <ul> <li>California</li> </ul> </li> <li>"us-west3" <ul> <li>Salt Lake City</li> </ul> </li> <li>"us-west4" <ul> <li>Las Vegas</li> </ul> </li> <li>"northamerica-northeast1" <ul> <li>Montréal</li> </ul> </li> <li>"northamerica-northeast2" <ul> <li>Toronto</li> </ul> </li> <li>"southamerica-east1" <ul> <li>São Paulo</li> </ul> </li> <li>"southamerica-west1" <ul> <li>Santiago</li> </ul> </li> <li>"asia1" <ul> <li>Dual region: asia-northeast1 and asia-northeast2.</li> </ul> </li> <li>"eur4" <ul> <li>Dual region: europe-north1 and europe-west4.</li> </ul> </li> <li>"nam4" <ul> <li>Dual region: us-central1 and us-east1.</li> </ul> </li> </ul> </li> </ul> <h4 id="gcs-storage-class">--gcs-storage-class</h4> <p>The storage class to use when storing objects in Google Cloud Storage.</p> <p>Properties:</p> <ul> <li>Config: storage_class</li> <li>Env Var: RCLONE_GCS_STORAGE_CLASS</li> <li>Type: string</li> <li>Required: false</li> <li>Examples: <ul> <li>"" <ul> <li>Default</li> </ul> </li> <li>"MULTI_REGIONAL" <ul> <li>Multi-regional storage class</li> </ul> </li> <li>"REGIONAL" <ul> <li>Regional storage class</li> </ul> </li> <li>"NEARLINE" <ul> <li>Nearline storage class</li> </ul> </li> <li>"COLDLINE" <ul> <li>Coldline storage class</li> </ul> </li> <li>"ARCHIVE" <ul> <li>Archive storage class</li> </ul> </li> <li>"DURABLE_REDUCED_AVAILABILITY" <ul> <li>Durable reduced availability storage class</li> </ul> </li> </ul> </li> </ul> <h4 id="gcs-env-auth">--gcs-env-auth</h4> <p>Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars).</p> <p>Only applies if service_account_file and service_account_credentials is blank.</p> <p>Properties:</p> <ul> <li>Config: env_auth</li> <li>Env Var: RCLONE_GCS_ENV_AUTH</li> <li>Type: bool</li> <li>Default: false</li> <li>Examples: <ul> <li>"false" <ul> <li>Enter credentials in the next step.</li> </ul> </li> <li>"true" <ul> <li>Get GCP IAM credentials from the environment (env vars or IAM).</li> </ul> </li> </ul> </li> </ul> <h3 id="advanced-options">Advanced options</h3> <p>Here are the Advanced options specific to google cloud storage (Google Cloud Storage (this is not Google Drive)).</p> <h4 id="gcs-token">--gcs-token</h4> <p>OAuth Access Token as a JSON blob.</p> <p>Properties:</p> <ul> <li>Config: token</li> <li>Env Var: RCLONE_GCS_TOKEN</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-auth-url">--gcs-auth-url</h4> <p>Auth server URL.</p> <p>Leave blank to use the provider defaults.</p> <p>Properties:</p> <ul> <li>Config: auth_url</li> <li>Env Var: RCLONE_GCS_AUTH_URL</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-token-url">--gcs-token-url</h4> <p>Token server url.</p> <p>Leave blank to use the provider defaults.</p> <p>Properties:</p> <ul> <li>Config: token_url</li> <li>Env Var: RCLONE_GCS_TOKEN_URL</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-directory-markers">--gcs-directory-markers</h4> <p>Upload an empty object with a trailing slash when a new directory is created</p> <p>Empty folders are unsupported for bucket based remotes, this option creates an empty object ending with "/", to persist the folder.</p> <p>Properties:</p> <ul> <li>Config: directory_markers</li> <li>Env Var: RCLONE_GCS_DIRECTORY_MARKERS</li> <li>Type: bool</li> <li>Default: false</li> </ul> <h4 id="gcs-no-check-bucket">--gcs-no-check-bucket</h4> <p>If set, don't attempt to check the bucket exists or create it.</p> <p>This can be useful when trying to minimise the number of transactions rclone does if you know the bucket exists already.</p> <p>Properties:</p> <ul> <li>Config: no_check_bucket</li> <li>Env Var: RCLONE_GCS_NO_CHECK_BUCKET</li> <li>Type: bool</li> <li>Default: false</li> </ul> <h4 id="gcs-decompress">--gcs-decompress</h4> <p>If set this will decompress gzip encoded objects.</p> <p>It is possible to upload objects to GCS with "Content-Encoding: gzip" set. Normally rclone will download these files as compressed objects.</p> <p>If this flag is set then rclone will decompress these files with "Content-Encoding: gzip" as they are received. This means that rclone can't check the size and hash but the file contents will be decompressed.</p> <p>Properties:</p> <ul> <li>Config: decompress</li> <li>Env Var: RCLONE_GCS_DECOMPRESS</li> <li>Type: bool</li> <li>Default: false</li> </ul> <h4 id="gcs-endpoint">--gcs-endpoint</h4> <p>Endpoint for the service.</p> <p>Leave blank normally.</p> <p>Properties:</p> <ul> <li>Config: endpoint</li> <li>Env Var: RCLONE_GCS_ENDPOINT</li> <li>Type: string</li> <li>Required: false</li> </ul> <h4 id="gcs-encoding">--gcs-encoding</h4> <p>The encoding for the backend.</p> <p>See the <a href="/overview/#encoding">encoding section in the overview</a> for more info.</p> <p>Properties:</p> <ul> <li>Config: encoding</li> <li>Env Var: RCLONE_GCS_ENCODING</li> <li>Type: Encoding</li> <li>Default: Slash,CrLf,InvalidUtf8,Dot</li> </ul> <h4 id="gcs-description">--gcs-description</h4> <p>Description of the remote.</p> <p>Properties:</p> <ul> <li>Config: description</li> <li>Env Var: RCLONE_GCS_DESCRIPTION</li> <li>Type: string</li> <li>Required: false</li> </ul> <h2 id="limitations">Limitations</h2> <p><code>rclone about</code> is not supported by the Google Cloud Storage backend. Backends without this capability cannot determine free space for an rclone mount or use policy <code>mfs</code> (most free space) as a member of an rclone union remote.</p> <p>See <a href="https://rclone.org/overview/#optional-features">List of backends that do not support rclone about</a> and <a href="https://rclone.org/commands/rclone_about/">rclone about</a></p> </div> <div class="col-md-3"> <div class="card"> <div class="card-header" style="padding: 5px 10px;"> Contents </div> <div class="card-body"> <nav id="TableOfContents"> <ul> <li><a href="#configuration">Configuration</a> <ul> <li><a href="#service-account-support">Service Account support</a></li> <li><a href="#anonymous-access">Anonymous Access</a></li> <li><a href="#application-default-credentials">Application Default Credentials</a></li> <li><a href="#fast-list">--fast-list</a></li> <li><a href="#custom-upload-headers">Custom upload headers</a></li> <li><a href="#modification-times">Modification times</a></li> <li><a href="#restricted-filename-characters">Restricted filename characters</a></li> <li><a href="#standard-options">Standard options</a></li> <li><a href="#advanced-options">Advanced options</a></li> </ul> </li> <li><a href="#limitations">Limitations</a></li> </ul> </nav> <p></p> </div> </div> <div class="card"> <div class="card-header" style="padding: 5px 15px;"> Platinum Sponsor </div> <div class="card-body"> <a href="https://www.backblaze.com/cloud-storage?utm_source=publisher&utm_medium=paid&utm_campaign=break-free-app-storage-q224-rclone" target="_blank" rel="noopener" title="Visit rclone's sponsor Backblaze"><img src="/img/logos/backblaze.svg"></a><br /> </div> </div> <div class="card"> <div class="card-header" style="padding: 5px 15px;"> Gold Sponsor </div> <div class="card-body"> <a href="https://www.idrive.com/e2/?refer=rclone" target="_blank" rel="noopener" title="Visit rclone's sponsor IDrive e2"><img src="/img/logos/idrive_e2.svg" viewBox="0 0 60 55"></a><br /> </div> </div> <div class="card"> <div class="card-header" style="padding: 5px 10px;"> Share and Enjoy </div> <div class="card-body"> <p class="menu"> <i class="fab fa-twitter fa-fw" aria-hidden="true"></i> <a href="https://twitter.com/intent/tweet/?text=rclone%20-%20rsync%20for%20cloud%20storage%20from%20%40njcw&url=https%3A%2F%2Frclone.org" target="_blank" rel="noopener" aria-label="Share on Twitter">Twitter</a><br /> <i class="fab fa-facebook fa-fw" aria-hidden="true"></i> <a href="https://facebook.com/sharer/sharer.php?u=https%3A%2F%2Frclone.org" target="_blank" rel="noopener" aria-label="Share on Facebook">Facebook</a><br /> <i class="fab fa-reddit fa-fw" aria-hidden="true"></i> <a href="https://reddit.com/submit/?url=https%3A%2F%2Frclone.org&resubmit=true&title=rclone%20-%20rsync%20for%20cloud%20storage" target="_blank" rel="noopener" aria-label="Share on Reddit">Reddit</a><br /> <iframe src="//ghbtns.com/github-btn.html?user=rclone&repo=rclone&type=star&count=true" allowtransparency="true" frameborder="0" scrolling="no" width="120" height="20"></iframe> </p> </div> </div> <div class="card"> <div class="card-header" style="padding: 5px 15px;"> Links </div> <div class="card-body"> <p class="menu"> <i class="fa fa-comments fa-fw" aria-hidden="true"></i> <a href="https://forum.rclone.org">Rclone forum</a><br /> <i class="fab fa-github fa-fw" aria-hidden="true"></i> <a href="https://github.com/rclone/rclone">GitHub project</a><br /> <i class="fa fa-book fa-fw" aria-hidden="true"></i> <a href="https://github.com/rclone/rclone/wiki">Rclone Wiki</a><br /> <i class="fa fa-heart heart fa-fw" aria-hidden="true"></i> <a href="/sponsor/">Sponsor</a><br /> <i class="fab fa-twitter fa-fw" aria-hidden="true"></i> <a href="https://twitter.com/njcw">@njcw</a> </p> </div> </div> </div> </div> <footer> <div class="row"> <div class="col-md-10"> <div class="card card-body"> <p style="font-size: 90%;"> © <a href="https://www.craig-wood.com/nick/" target="blank">Nick Craig-Wood</a> 2014-2024<br> Source file <a href="https://github.com/rclone/rclone/blob/master/docs/content/googlecloudstorage.md" target="blank">googlecloudstorage.md</a> last updated <a href="https://github.com/rclone/rclone/commit/da25305ba0279abfdaad71ad031d36c447500f2b">2024-08-16</a><br> Uploaded with <a href="https://rclone.org">rclone</a>. Built with <a href="https://gohugo.io/" target="blank">Hugo</a>. Logo by <a href="https://twitter.com/andy23" target="blank">@andy23</a>. Served by <a href="https://caddyserver.com/" target="blank">Caddy</a>. Hosted at <a href="https://hetzner.cloud/?ref=62WcciVmlzHt" title="Get €⁠20 in cloud credits" target="blank">Hetzner Cloud</a>. </p> </div> </div> </div> </footer> </div> <script src="/js/jquery.min.3.5.1.js"></script> <script src="/js/popper.min.1.16.0.js"></script> <script src="/js/bootstrap.min.4.4.1.js"></script> <script src="/js/custom.js?r=-62135596800"></script> <script src="/js/search.js?r=-62135596800"></script> </body> </html>

CINXE.COM

Google Cloud Storage