storagectl
Enumerate and mount storage volumes provided by systemd storage providers
TLDR
SYNOPSIS
storagectl [OPTIONS...] {COMMAND} [NAME...]
DESCRIPTION
storagectl is a command-line tool to inspect storage providers and the storage volumes they expose. It is part of the systemd project.A storage provider implements the `io.systemd.StorageProvider` Varlink interface and registers an AF_UNIX socket under `/run/systemd/io.systemd.StorageProvider/` (system) or the user equivalent.systemd ships two providers:- `systemd-storage-block@.service` — exposes the system's block devices.- `systemd-storage-fs@.service` — exposes regular files and directories from a backing filesystem (supports on-the-fly creation via templates).storagectl can also act as a mount helper (`mount -t storage ...` or `mount -t storage.FSTYPE ...`) to acquire and mount volumes at arbitrary locations. The source is specified as `PROVIDER:VOLUME`.
OPTIONS
--system
Operate on system providers (default).--user
Operate on per-user providers.--json=MODE
Output as JSON ("short", "pretty", or "off").--no-pager, --no-legend, --no-ask-password
Control output and authentication behavior.
COMMANDS
volumes [GLOB]
List volumes (default command). Optional glob filters volume names.templates [GLOB]
List supported volume templates (for providers that support dynamic creation).providers
List known storage providers and whether their sockets are reachable.
CAVEATS
This tool is relatively new (added in systemd 261). Storage providers are an experimental/low-level interface primarily for advanced use cases and other systemd components (e.g. machinectl).
SEE ALSO
systemctl(1), mount(8), machinectl(1)
