- NAME
-
- gcloud cloud-shell scp - copies files between Cloud Shell and the local machine
- SYNOPSIS
-
-
gcloud cloud-shell scp(cloudshell|localhost) :SRC[(cloudshell|localhost):SRC…] (cloudshell|localhost) :DEST[--dry-run] [--force-key-file-overwrite] [--recurse] [--scp-flag=SCP_FLAG] [--ssh-key-file] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
gcloud cloud-shell scpcopies files between your Cloud Shell instance and your local machine using the scp command. - EXAMPLES
- To denote a file in Cloud Shell, prefix the file name with the string
"cloudshell:" (e.g.
cloudshell:~/FILE). To denote a local file, prefix the file name with the string "localhost:" (e.g.localhost:~/FILE). For example, to copy a remote directory to your local machine, run:gcloud cloud-shell scp cloudshell:~/REMOTE-DIR localhost:~/LOCAL-DIRIn the above example,
~/REMOTE-DIRLOCAL-DIRdirectory.Conversely, files from your local computer can be copied into Cloud Shell:
gcloud cloud-shell scp localhost:~/LOCAL-FILE-1 localhost:~/LOCAL-FILE-2 cloudshell:~/REMOTE-DIRUnder the covers,
scp(1)or pscp (on Windows) is used to facilitate the transfer. - POSITIONAL ARGUMENTS
-
- cloudshell
|
localhost):SRC-[(cloudshell|localhost):SRC-…]"> (cloudshell|localhost):SRC[(cloudshell|localhost):SRC…] - Specifies the files to copy.
- cloudshell
|
localhost):DEST"> (cloudshell|localhost):DEST - Specifies a destination for the source files.
- cloudshell
|
- FLAGS
-
-
--dry-run - If provided, prints the command that would be run to standard out instead of executing it.
-
--force-key-file-overwrite - If enabled gcloud will regenerate and overwrite the files associated with a
broken SSH key without asking for confirmation in both interactive and
non-interactive environment.
If disabled gcloud will not attempt to regenerate the files associated with a broken SSH key and fail in both interactive and non-interactive environment.
-
--recurse - Upload directories recursively.
-
--scp-flag=SCP_FLAG - Extra flag to be sent to scp. This flag may be repeated.
-
--ssh-key-file - The path to the SSH key file. By default, this is
~/.ssh/google_compute_engine.
-
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
- These variants are also available:
gcloud alpha cloud-shell scpgcloud beta cloud-shell scp
gcloud cloud-shell scp
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-06-09 UTC.
