atlas acl

file version: 10 July 2026

Overview

atlas acl views, grants, revokes, or clears POSIX ACL entries on files and directories.

Permissions use rwx notation, for example r-x, rwx, and r--.

Commands

Command	Description
acl <path>	Show current ACL
acl grant <user|group>:<name> <perms> <path>	Grant access
acl revoke <user|group>:<name> <path>	Revoke access
acl clear <path>	Remove all extended ACL entries

Usage

atlas acl <command> [flags] <path> [paths...]

Command Flags

Flag	Description
-d, --default	Set/view default ACL, inherited by new files in directory
-r, --recursive	Apply recursively
-e, --regexp string	Regexp pattern matched against file paths
-n, --dry-run	Show what would be changed without making changes

Examples

atlas acl /users/nds
atlas acl grant user:meghan r-x /users/nds
atlas acl grant group:devs rwx /data/project
atlas acl grant -d user:meghan r-x /users/nds
atlas acl revoke user:meghan /users/nds
atlas acl clear /users/nds
atlas acl grant -r user:meghan r-x /users/nds

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