​

vers copy

​

Usage

vers copy [vm-id|alias]  
vers copy    # Uses HEAD VM

​

Options

​

Examples

​

Upload a file to a VM

vers copy vm-123 ./local-file.txt /remote/path/

​

Download a file from a VM

vers copy vm-123 /remote/path/file.txt ./local-file.txt

​

Use HEAD VM for file transfer

# Upload using current HEAD VM
vers copy ./local-file.txt /remote/path/

# Download using current HEAD VM  
vers copy /remote/path/file.txt ./local-file.txt

​

Copy directories recursively

# Upload entire directory
vers copy -r ./local-directory/ /remote/path/

# Download entire directory
vers copy -r /remote/path/directory/ ./local-directory/

​

How it works

1. VM validation: Ensures the target VM is running and has SSH access
2. SSH key management: Creates or retrieves the appropriate SSH key for the VM
3. Network routing: Determines the correct connection method (direct IP or through cluster node)
4. Transfer direction: Auto-detects whether you’re uploading or downloading based on path patterns

​

Path detection

• Local paths: Don’t start with / or exist on your local filesystem
• Remote paths: Start with / (absolute paths on the VM)
• Auto-detection: If a local file exists, the command assumes upload; otherwise, it assumes download

​

Prerequisites

• VM must be in “Running” state
• VM must have SSH port configured
• Valid authentication (handled automatically)

​

Common Patterns

​

Upload a project tree

vers copy -r ./my-app /srv/app

​

Pull remote logs for local inspection

vers copy my-vm /var/log/app.log ./debug/

​

Same file to N branches

for i in $(seq 1 5); do
  vers copy "worker-$i" ./config.json /etc/app/config.json
done

​

Deploy a new binary to HEAD

vers copy ./dist/server /opt/app/server
vers execute -- systemctl restart app

​

See Also

• vers connect - SSH into a VM interactively
• vers execute - Run commands on a VM
• vers status - Check VM state