Stay organized with collections
Save and categorize content based on your preferences.
Use secure copy (SCP) from the command line to transfer files to
Google Distributed Cloud air-gapped virtual machine (VM) instances.
Before you begin
You need the following to use the SCP command-line tool to
transfer files to VMs:
You must manually manage your SSH keys.
You must enable ingress on port 22 for your VM. See the Enable IP addresses page for more information.
The SCP tool uses the same key files that you use to connect to your instances
using standard SSH.
Request permissions and access
To perform the tasks listed in this page, you must have the Project
VirtualMachine Admin role. Follow the steps to
verify
that you have the Project VirtualMachine Admin (project-vm-admin) role in the namespace
of the project where the VM resides.
Transfer files to VMs
Locate the external IP address for the VM to which you want to send files using
the instructions on the Enable IP addresses
page.
Use the SCP tool to copy a file from your workstation to the home directory of
the target VM in the following example, which uses a private key at
~/.ssh/my-ssh-key:
The name of the local file
that you want to upload.
USERNAME
Your username.
IP_ADDRESS
The VM's external ingress IP address.
Transfer files from a VM
To copy files from a VM to your local workstation, reverse the source and
destination variables. The following example shows how to copy a file from your
VM to a path on your workstation:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-21 UTC."],[[["SCP (secure copy) is used to transfer files to and from Google Distributed Cloud air-gapped virtual machine (VM) instances via the command line."],["To use SCP, you must have access management enabled, manually manage your SSH keys, and enable ingress on port 22 for your VM."],["Transfer files to a VM by using the SCP command `scp -i ~/.ssh/my-ssh-key LOCAL_FILE_PATH USERNAME@IP_ADDRESS:~`, replacing the variables with your file path, username, and the VM's external IP."],["Transfer files from a VM to your workstation using the SCP command `scp -i ~/.ssh/my-ssh-key USERNAME@IP_ADDRESS:REMOTE_FILE_PATH LOCAL_FILE_PATH`, replacing variables with your credentials and file paths."],["You must have the Project VirtualMachine Admin role to perform file transfer tasks to VMs."]]],[]]
