← CLI Reference

cp

Copy an existing VM

Usage

cp <source-vm> [new-name] [--pool=<name>] [--memory=<size>] [--cpu=<count>] [--disk=<size>]

Options

  • --copy-tags: copy tags from source VM (use --copy-tags=false to disable)
  • --cpu: number of CPUs
  • --disk: disk size (e.g., 20, 20GB, 50G)
  • --json: output in JSON format
  • --memory: memory allocation (e.g., 4, 4GB, 8G)
  • --pool: create the copy in one of your team's pools (see 'pool list')
  • --sandbox: alias for --standalone
  • --standalone: create the copy as a standalone VM with its own reserved capacity (requires a plan with standalone VMs and team approval)

Examples

cp my-vm                          # copy with auto-generated name
cp my-vm my-vm-copy               # copy with specific name
cp my-vm --cpu=4 --memory=16GB    # copy with different resources
cp my-vm my-pool-copy --pool=build # copy into a team pool
cp my-vm --copy-tags=false        # copy without tags