NAME

limactl-copy - Copy files between host and guest

SYNOPSIS

limactl copy SOURCE ... TARGET [flags]

DESCRIPTION

Copy files between host and guest

Prefix guest filenames with the instance name and a colon.

Backends:
auto - Automatically selects the best available backend (rsync preferred, falls back to scp)
rsync - Uses rsync for faster transfers with resume capability (requires rsync on both host and guest)
scp - Uses scp for reliable transfers (always available)

Not to be confused with 'limactl clone'.

OPTIONS

--backend="auto" Copy backend (scp|rsync|auto)

-h, --help[=false] help for copy

-r, --recursive[=false] Copy directories recursively

-v, --verbose[=false] Enable verbose output

OPTIONS INHERITED FROM PARENT COMMANDS

--debug[=false] Debug mode

--log-format="text" Set the logging format [text, json]

--log-level="" Set the logging level [trace, debug, info, warn, error]

--tty[=false] Enable TUI interactions such as opening an editor. Defaults to true when stdout is a terminal. Set to false for automation.

-y, --yes[=false] Alias of --tty=false

EXAMPLE

  # Copy file from guest to host (auto backend)


  limactl copy default:/etc/os-release .


  # Copy file from host to guest with verbose output


  limactl copy -v myfile.txt default:/tmp/


  # Copy directory recursively using rsync backend


  limactl copy --backend=rsync -r ./mydir default:/tmp/


  # Copy using scp backend specifically


  limactl copy --backend=scp default:/var/log/app.log ./logs/


  # Copy multiple files


  limactl copy file1.txt file2.txt default:/tmp/

SEE ALSO

limactl(1)