atlas tag

file version: 10 July 2026

Overview

atlas tag manages user-defined tags and attributes on files.

With no subcommand, it lists current tags and attributes.

The add/set/modify/rm verbs target the user-tag store at user.atlas.tags by default. Pass --admin to target the admin-tag store at scoutfs.hide.atlas.tags instead; this requires the tags.write_admin capability and a ScoutFS resource.

Usage

atlas tag [flags] PATH
atlas tag [command]

Commands

Command	Description
add	Add a new tag or attribute (fails if exists)
modify	Update an existing tag or attribute (fails if not set)
rm	Remove a tag or attribute
set	Set a tag or attribute (upsert — creates or updates)

Examples

atlas tag /data/photo.jpg
atlas tag add --name important /data/photo.jpg
atlas tag set --name priority --value high /data/photo.jpg
atlas tag set --admin --name reviewed --value 2026-06-11 /data/photo.jpg
atlas tag modify --name priority --value low /data/photo.jpg
atlas tag rm --name important /data/photo.jpg

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