vastai cloud copy

Copy files/folders to and from cloud providers

Usage

vastai cloud copy --src SRC --dst DST --instance INSTANCE_ID --connection CONNECTION_ID --transfer TRANSFER_TYPE

Options

--src · string

path to source of object to copy

--dst · string · default: "/workspace"

path to target of copy operation

--instance · string

id of the instance

--connection · string

id of cloud connection on your account (get from calling ‘vastai show connections’)

--transfer · string · default: "Instance to Cloud"

type of transfer, possible options include Instance To Cloud and Cloud To Instance

--dry-run · boolean

show what would have been transferred

--size-only · boolean

skip based on size only, not mod-time or checksum

--ignore-existing · boolean

skip all files that exist on destination

--update · boolean

skip files that are newer on the destination

--delete-excluded · boolean

delete files on dest excluded from transfer

--schedule · string

try to schedule a command to run hourly, daily, or weekly. Valid values are HOURLY, DAILY, WEEKLY For ex. —schedule DAILY Allowed values: HOURLY, DAILY, WEEKLY

--start_date · string · default: "2026-09-09"

Start date/time in format ‘YYYY-MM-DD HH:MM:SS PM’ (UTC). Default is now. (optional)

--end_date · string

End date/time in format ‘YYYY-MM-DD HH:MM:SS PM’ (UTC). Default is contract’s end. (optional)

--day · parse_day_cron_style

Day of week you want scheduled job to run on (0-6, where 0=Sunday) or ”*”. Default will be 0. For ex. —day 0

--hour · parse_hour_cron_style

Hour of day you want scheduled job to run on (0-23) or ”*” (UTC). Default will be 0. For ex. —hour 16

Description

Copies a directory from a source location to a target location. Each of source and destination directories can be either local or remote, subject to appropriate read and write permissions required to carry out the action. The format for both src and dst is [instance_id:]path. You can find more information about the cloud copy operation here: https://vast.ai/docs/gpu-instances/cloud-sync

Examples

vastai show connections
 ID    NAME      Cloud Type
 1001  test_dir  drive
 1003  data_dir  drive
 1004  hf_data   hf

 vastai cloud copy --src /folder --dst /workspace --instance 6003036 --connection 1001 --transfer "Instance To Cloud"
 vastai cloud copy --src my-bucket/data --dst /workspace --instance 6003036 --connection 1004 --transfer "Cloud To Instance"

The first cloud copy example copies all contents of /folder on instance 6003036 into /workspace in gdrive connection 'test_dir'.
The second cloud copy example copies my-bucket/data from Hugging Face connection 'hf_data' into /workspace on the instance.

Note: Hugging Face cloud destinations must already exist as bucket paths; directories are not created automatically.

Global Options

The following options are available for all commands:

Option	Description
--url URL	Server REST API URL
--retry N	Retry limit
--raw	Output machine-readable JSON
--explain	Verbose explanation of API calls
--api-key KEY	API key (defaults to ~/.config/vastai/vast_api_key)