atlas download

file version: 10 July 2026

Overview

atlas download fetches files or directory trees from the server to a local destination. It can optionally bundle remote content into an archive before downloading.

Usage

atlas download [flags] <remote-path...> <local-path>

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 locally
--modify-window int	Tolerate mtime drift in seconds under --update
-n, --dry-run	Show what would happen without downloading anything

Other Flags

Flag	Description
-r, --recursive	Recursively download directories
-a, --archive string	Bundle content into an archive before downloading

Examples

atlas download /hsm/arch/project/report.pdf ./report.pdf
atlas download --update -r /remote/project ./          # rsync-style restart
atlas download --ignore-existing -r /remote/project ./
atlas download -n -r /remote/project ./                # preview only
atlas download --archive tar /remote/project/ ./backup.tar.gz

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