atlas upload

file version: 10 July 2026

Overview

atlas upload uploads local files to the Atlas server. Without --archive it uploads a single file or directory tree. With --archive it bundles multiple files or directories into an archive before uploading.

Usage

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

Restart Behavior

These flags control what happens when the destination already exists.

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 on the remote
--modify-window int	Tolerate mtime drift in seconds under --update
-n, --dry-run	Show what would happen without uploading

Other Flags

Flag	Description
-r, --recursive	Recursively upload directories
-a, --archive string	Bundle files into an archive before uploading
-h, --help	Show help for upload

Examples

atlas upload photo.jpg /data/photos/photo.jpg
atlas upload report.pdf /shared/reports/report.pdf --force
atlas upload --update -r ./project /remote/
atlas upload --ignore-existing -r ./project /remote/
atlas upload -n -r ./project /remote/
atlas upload --archive tar ./src ./docs /remote/code.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