pvesm

Configure Proxmox storage backends

TLDR

Get status for all datastores

$ pvesm status

List storage contents

$ pvesm list [storage_name]

Add a directory storage

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

Set storage to contain specific content

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

Delete a file from storage

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

Remove a storage

$ pvesm remove [storage_name]

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.