pvesm

Configure Proxmox storage backends

TLDR

Show every storage and whether it is online

$ pvesm status

List the contents of one storage

$ pvesm list [storage_name]

Resolve a stored file to its path on disk

$ pvesm path [local]:iso/[filename.iso]

Add a directory-backed storage

$ pvesm add dir [storage_name] --path [path/to/directory]

Restrict what a storage may hold

$ pvesm set [storage_name] --content [iso,backup,vztmpl]

Disable a storage without deleting its definition

$ pvesm set [storage_name] --disable 1

Delete a file from a storage

$ pvesm free [local]:iso/[filename.iso]

Remove the storage definition

$ pvesm remove [storage_name]

Scan a server for NFS exports worth adding

$ pvesm scan nfs [server_address]

SYNOPSIS

pvesm command [storage] [options]

pvesm manages Proxmox VE storage definitions. It configures storage backends for VM disk images, ISO files, container templates, and backups. Supported storage types include local directories, NFS, CIFS, LVM, ZFS, Ceph, and iSCSI.Storage configuration is cluster-wide; changes propagate to all nodes. Each storage can be limited to specific content types and made available on selected nodes.

PARAMETERS

status, st

Show status of all storage

list, l storage

List contents of specified storage

add type storage options

Add new storage definition

set storage options

Modify storage configuration

remove, r storage

Remove storage definition

free volume

Delete a volume/file from storage

--content types

Allowed content types (iso, images, rootdir, vztmpl, backup)

--path path

Directory path (for dir type)

CAVEATS

Removing storage definition does not delete data. Storage must be accessible from all nodes where it's enabled. Some storage types require additional packages or configuration.

HISTORY

Part of Proxmox VE, providing unified storage management for virtualization. Abstracts different storage backends behind a consistent interface used by qm and pct for VM and container storage.