atlas mv

file version: 10 July 2026

Overview

atlas mv moves or renames files and directories on the server.

Usage

atlas mv [flags] <source...> <destination>

Restart Behavior

These flags control overwrite and restart behavior.

Flag	Description
-f, --force	Overwrite unconditionally
-u, --update	Skip if destination is at least as new as source
--ignore-existing	Skip files that already exist at the destination
--modify-window int	Tolerate mtime drift in seconds under --update
-n, --dry-run	Show what would happen without moving anything

Other Flags

Flag	Description
-t, --target-directory string	Move all sources into the given destination directory
-h, --help	Show help for mv

Examples

atlas mv /hsm/arch/project/file.txt /hsm/arch/project/archive/
atlas mv -t /hsm/arch/project/archive /hsm/arch/project/file1 /hsm/arch/project/file2
atlas mv --update /data/archive/* /backup/         # skip up-to-date
atlas ls -R -0 /src | xargs -0 atlas mv -t /dst     # NUL-safe batch move

Global Flags

Flag	Description
--ca-cert string	Path to CA certificate for server verification
--format string	Machine-readable output format (json or csv); omit for the default human-readable output
-L, --lang string	Interface language (en, de)
--no-color	Disable color output
-P, --plaintext	Use plaintext (non-TLS) connection
-s, --server string	ATLAS server address; defaults to ACLI_SERVER, then the stored session, /etc/atlas/atlas.conf, and finally localhost:7449
--tls-skip-verify	Skip TLS certificate verification; enabled by default for self-signed setups