atlas stage

file version: 10 July 2026

Overview

atlas stage requests that offline (archived) files be brought back online. The server queues the stage operation and reports how many files were staged.

With --cancel (-x), it cancels a pending stage request instead of issuing a new one.

Usage

atlas stage <path> [paths...] [flags]

Command Flags

Flag	Description
-x, --cancel	Cancel a pending stage request
-r, --recursive	Stage files recursively in directories
-e, --regexp string	Match paths by regular expression
-n, --dry-run	Show what would be staged without staging

Examples

atlas stage /archive/dataset.tar
atlas stage -r /archive/project/
atlas stage -e '\.nc$' -r /archive
atlas stage -x /archive/dataset.tar

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