proxmox-backup-manager

Synopsis


proxmox-backup-manager acl list [OPTIONS]

Access Control list.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager acl update <path> <role> [OPTIONS]

Update Access Control List (ACLs).

<path><string>

Access control path.

<role><role>

Enum representing roles via their [PRIVILEGES] combination.

Since privileges are implemented as bitflags, each unique combination of privileges maps to a single, unique u64 value that is used in this enum definition.

Optional parameters:

--auth-id <string>

Authentication ID

--delete <boolean>

Remove permissions (instead of adding it).

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--group <string>

Group ID

--propagate <boolean>   (default=true)

Allow to propagate (inherit) permissions.



proxmox-backup-manager acme account deactivate <name> [OPTIONS]

Deactivate an ACME account.

<name><string>

ACME account name.

Optional parameters:

--force <boolean>   (default=false)

Delete account data even if the server refuses to deactivate the account.


proxmox-backup-manager acme account info <name> [OPTIONS]

Show acme account information.

<name><string>

ACME account name.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager acme account list [OPTIONS]

List acme accounts.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager acme account register <name> <contact> [OPTIONS]

Register an ACME account.

<name><string>

ACME account name.

<contact><string>

List of email addresses.

Optional parameters:

--directory <string>

The ACME Directory.


proxmox-backup-manager acme account update <name> [OPTIONS]

Update an ACME account.

<name><string>

ACME account name.

Optional parameters:

--contact <string>

List of email addresses.


proxmox-backup-manager acme cert order [OPTIONS]

Order a new ACME certificate.

Optional parameters:

--force <boolean>   (default=false)

Force renewal even if the certificate does not expire soon.


proxmox-backup-manager acme cert revoke

Order a new ACME certificate.


proxmox-backup-manager acme plugin add <type> <id> --api <string> --data <string> [OPTIONS]

Show acme account information.

<type><string>

The ACME challenge plugin type.

<id><string>

ACME Challenge Plugin ID.

--api <string>

DNS API Plugin Id.

--data <string>

File containing the plugin data.

Optional parameters:

--disable <boolean>   (default=false)

Flag to disable the config.

--validation-delay <integer> (0 - 172800)   (default=30)

Extra delay in seconds to wait before requesting validation.

Allows to cope with long TTL of DNS records.


proxmox-backup-manager acme plugin config <id> [OPTIONS]

Show acme account information.

<id><string>

Plugin ID

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager acme plugin list [OPTIONS]

List acme plugins.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager acme plugin remove <id>

Delete an ACME plugin configuration.

<id><string>

ACME Challenge Plugin ID.


proxmox-backup-manager acme plugin set <id> [OPTIONS]

Update an ACME plugin configuration.

<id><string>

ACME Challenge Plugin ID.

Optional parameters:

--api <string>

DNS API Plugin Id.

--data <string>

DNS plugin data (base64 encoded with padding).

--delete disable|validation-delay

List of properties to delete. Can be specified more than once.

--digest <string>

Digest to protect against concurrent updates

--disable <boolean>   (default=false)

Flag to disable the config.

--validation-delay <integer> (0 - 172800)   (default=30)

Extra delay in seconds to wait before requesting validation.

Allows to cope with long TTL of DNS records.


proxmox-backup-manager ad create <realm> --server1 <string> [OPTIONS]

Create a new AD realm

<realm><string>

Realm name.

--server1 <string>

AD server address

Optional parameters:

--base-dn <string>

LDAP Domain

--bind-dn <string>

LDAP Domain

--capath <string>

CA certificate to use for the server. The path can point to either a file, or a directory. If it points to a file, the PEM-formatted X.509 certificate stored at the path will be added as a trusted certificate. If the path points to a directory, the directory replaces the system's default certificate store at /etc/ssl/certs - Every file in the directory will be loaded as a trusted certificate.

--comment <string>

Comment.

--filter <string>

Custom LDAP search filter for user sync

--mode ldap|ldap+starttls|ldaps   (default=ldap)

LDAP connection type

--password <string>

AD bind password

--port <integer> (0 - 65535)

AD server Port

--server2 <string>

Fallback AD server address

--sync-attributes [[email=<string>] [,firstname=<string>] [,lastname=<string>]]

Comma-separated list of key=value pairs for specifying which LDAP attributes map to which PBS user field. For example, to map the LDAP attribute mail to PBS's email, write email=mail.

--sync-defaults-options [[enable-new=<1|0>] [,remove-vanished=<string>]]

sync defaults options

--user-classes [<string>, ...]   (default=inetorgperson,posixaccount,person,user)

Comma-separated list of allowed objectClass values for user synchronization. For instance, if user-classes is set to person,user, then user synchronization will consider all LDAP entities where objectClass: person or objectClass: user.

--verify <boolean>   (default=false)

Verify server certificate


proxmox-backup-manager ad delete <realm> [OPTIONS]

Remove an LDAP realm configuration

<realm><string>

Realm name.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager ad list [OPTIONS]

List configured AD realms

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager ad show <realm> [OPTIONS]

Show AD realm configuration

<realm><string>

Realm name.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager ad sync <realm> [OPTIONS]

Sync a given LDAP realm

<realm><string>

Authentication domain ID

Optional parameters:

--dry-run <boolean>   (default=false)

If set, do not create/delete anything

--enable-new <boolean>

Enable newly synced users immediately

--remove-vanished [acl|entry|properties, ...]

A semicolon-separated list of things to remove when they or the user vanishes during user synchronization. The following values are possible: entry removes the user when not returned from the sync; properties removes any properties on existing user that do not appear in the source. acl removes ACLs when the user is not returned from the sync.


proxmox-backup-manager ad update <realm> [OPTIONS]

Update an AD realm configuration

<realm><string>

Realm name.

Optional parameters:

--base-dn <string>

LDAP Domain

--bind-dn <string>

LDAP Domain

--capath <string>

CA certificate to use for the server. The path can point to either a file, or a directory. If it points to a file, the PEM-formatted X.509 certificate stored at the path will be added as a trusted certificate. If the path points to a directory, the directory replaces the system's default certificate store at /etc/ssl/certs - Every file in the directory will be loaded as a trusted certificate.

--comment <string>

Comment.

--delete server2|port|comment|verify|mode|bind-dn|password|filter|sync-defaults-options|sync-attributes|user-classes

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--filter <string>

Custom LDAP search filter for user sync

--mode ldap|ldap+starttls|ldaps   (default=ldap)

LDAP connection type

--password <string>

AD bind password

--port <integer> (0 - 65535)

AD server Port

--server1 <string>

AD server address

--server2 <string>

Fallback AD server address

--sync-attributes [[email=<string>] [,firstname=<string>] [,lastname=<string>]]

Comma-separated list of key=value pairs for specifying which LDAP attributes map to which PBS user field. For example, to map the LDAP attribute mail to PBS's email, write email=mail.

--sync-defaults-options [[enable-new=<1|0>] [,remove-vanished=<string>]]

sync defaults options

--user-classes [<string>, ...]   (default=inetorgperson,posixaccount,person,user)

Comma-separated list of allowed objectClass values for user synchronization. For instance, if user-classes is set to person,user, then user synchronization will consider all LDAP entities where objectClass: person or objectClass: user.

--verify <boolean>   (default=false)

Verify server certificate


proxmox-backup-manager cert info

Display node certificate information.


proxmox-backup-manager cert update [OPTIONS]

Update node certificates and generate all needed files/directories.

Optional parameters:

--force <boolean>

Force generation of new SSL certificate.


proxmox-backup-manager datastore create <name> <path> [OPTIONS]

Create new datastore config.

<name><string>

Datastore name.

<path><string>

Either the absolute path to the datastore directory, or a relative on-device path for removable datastores.

Optional parameters:

--backing-device <string>

The UUID of the filesystem partition for removable datastores.

--comment <string>

Comment.

--gc-schedule <calendar-event>

Run garbage collection job at specified schedule.

--keep-daily <integer> (1 - N)

Number of daily backups to keep.

--keep-hourly <integer> (1 - N)

Number of hourly backups to keep.

--keep-last <integer> (1 - N)

Number of backups to keep.

--keep-monthly <integer> (1 - N)

Number of monthly backups to keep.

--keep-weekly <integer> (1 - N)

Number of weekly backups to keep.

--keep-yearly <integer> (1 - N)

Number of yearly backups to keep.

--maintenance-mode [type=<enum> [,message=<string>]]

Maintenance mode, type is either 'offline' or 'read-only', message should be enclosed in "

--notification-mode legacy-sendmail|notification-system   (default=legacy-sendmail)

Configure how notifications for this datastore should be sent. legacy- sendmail sends email notifications to the user configured in notify-user via the system's sendmail executable. notification-system emits matchable notification events to the notification system.

--notify [[gc=<enum>] [,prune=<enum>] [,sync=<enum>] [,verify=<enum>]]

Datastore notification setting, enum can be one of 'always', 'never', or 'error'.

--notify-user <string>

User ID

--output-format text|json|json-pretty

Output format.

--prune-schedule <calendar-event>

Run prune job at specified schedule.

--tuning [[chunk-order=<enum>] [,sync-level=<enum>]]

Datastore tuning options

--verify-new <boolean>

If enabled, all new backups will be verified right after completion.


proxmox-backup-manager datastore list [OPTIONS]

Datastore list.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager datastore mount <store> [OPTIONS]

Mount a removable datastore.

<store><string>

Datastore name.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager datastore remove <name> [OPTIONS]

Remove a datastore configuration.

<name><string>

Datastore name.

Optional parameters:

--destroy-data <boolean>   (default=false)

Delete the datastore's underlying contents

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--keep-job-configs <boolean>   (default=false)

If enabled, the job configurations related to this datastore will be kept.


proxmox-backup-manager datastore show <name> [OPTIONS]

Show datastore configuration

<name><string>

Datastore name.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager datastore unmount <store> [OPTIONS]

Unmount a removable datastore.

<store><string>

Datastore name.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager datastore update <name> [OPTIONS]

Update datastore configuration.

<name><string>

Datastore name.

Optional parameters:

--comment <string>

Comment.

--delete comment|gc-schedule|prune-schedule|keep-last|keep-hourly|keep-daily|keep-weekly|keep-monthly|keep-yearly|verify-new|notify-user|notify|notification-mode|tuning|maintenance-mode

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--gc-schedule <calendar-event>

Run garbage collection job at specified schedule.

--keep-daily <integer> (1 - N)

Number of daily backups to keep.

--keep-hourly <integer> (1 - N)

Number of hourly backups to keep.

--keep-last <integer> (1 - N)

Number of backups to keep.

--keep-monthly <integer> (1 - N)

Number of monthly backups to keep.

--keep-weekly <integer> (1 - N)

Number of weekly backups to keep.

--keep-yearly <integer> (1 - N)

Number of yearly backups to keep.

--maintenance-mode [type=<enum> [,message=<string>]]

Maintenance mode, type is either 'offline' or 'read-only', message should be enclosed in "

--notification-mode legacy-sendmail|notification-system   (default=legacy-sendmail)

Configure how notifications for this datastore should be sent. legacy- sendmail sends email notifications to the user configured in notify-user via the system's sendmail executable. notification-system emits matchable notification events to the notification system.

--notify [[gc=<enum>] [,prune=<enum>] [,sync=<enum>] [,verify=<enum>]]

Datastore notification setting, enum can be one of 'always', 'never', or 'error'.

--notify-user <string>

User ID

--output-format text|json|json-pretty

Output format.

--prune-schedule <calendar-event>

Run prune job at specified schedule.

--tuning [[chunk-order=<enum>] [,sync-level=<enum>]]

Datastore tuning options

--verify-new <boolean>

If enabled, all new backups will be verified right after completion.


proxmox-backup-manager datastore uuid-mount <uuid> [OPTIONS]

Try mounting a removable datastore given the UUID.

<uuid><string>

The UUID of the device that should be mounted

Optional parameters:

--output-format text|json|json-pretty

Output format.



proxmox-backup-manager disk fs create <name> --disk <string> [OPTIONS]

Create a Filesystem on an unused disk. Will be mounted under /mnt/datastore/<name>.

<name><string>

Datastore name.

--disk <string>

Block device name (/sys/block/<name>).

Optional parameters:

--add-datastore <boolean>

Configure a datastore using the directory.

--filesystem ext4|xfs

A file system type supported by our tooling.


proxmox-backup-manager disk fs delete <name>

Remove a Filesystem mounted under /mnt/datastore/<name>.

<name><string>

Datastore name.


proxmox-backup-manager disk fs list [OPTIONS]

List systemd datastore mount units.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager disk initialize <disk> [OPTIONS]

Initialize empty Disk with GPT

<disk><string>

Block device name (/sys/block/<name>).

Optional parameters:

--uuid <string>

UUID for the GPT table.


proxmox-backup-manager disk list [OPTIONS]

Local disk list.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager disk smart-attributes <disk> [OPTIONS]

Show SMART attributes.

<disk><string>

Block device name (/sys/block/<name>).

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager disk wipe <disk>

wipe disk

<disk><string>

(Partition) block device name (/sys/class/block/<name>).


proxmox-backup-manager disk zpool create <name> --devices [<string>, ...] --raidlevel single|mirror|raid10|raidz|raidz2|raidz3 [OPTIONS]

create a zfs pool

<name><string>

Datastore name.

--devices [<string>, ...]

A list of disk names, comma separated.

--raidlevel single|mirror|raid10|raidz|raidz2|raidz3

The ZFS RAID level to use.

Optional parameters:

--add-datastore <boolean>

Configure a datastore using the zpool.

--ashift <integer> (9 - 16)   (default=12)

Pool sector size exponent.

--compression gzip|lz4|lzjb|zle|zstd|on|off   (default=On)

The ZFS compression algorithm to use.


proxmox-backup-manager disk zpool list [OPTIONS]

Local zfs pools.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager dns get [OPTIONS]

Read DNS settings

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager dns set [OPTIONS]

Update DNS settings.

Optional parameters:

--delete dns1|dns2|dns3

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--dns1 <string>

First name server IP address.

--dns2 <string>

Second name server IP address.

--dns3 <string>

Third name server IP address.

--search <string>

Search domain for host-name lookup.


proxmox-backup-manager garbage-collection list [OPTIONS]

List garbage collection job status for all datastores, including datastores without gc jobs.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager garbage-collection start <store> [OPTIONS]

Start garbage collection for a specific datastore.

<store><string>

Datastore name.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager garbage-collection status <store> [OPTIONS]

Show garbage collection status for a specific datastore.

<store><string>

Datastore name.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager help [{<command>}] [OPTIONS]

Get help about specified command (or sub-command).

<command><string>

Command. This may be a list in order to specify nested sub-commands. Can be specified more than once.

Optional parameters:

--verbose <boolean>

Verbose help.


proxmox-backup-manager ldap create <realm> --base-dn <string> --server1 <string> --user-attr <string> [OPTIONS]

Create a new LDAP realm

<realm><string>

Realm name.

--base-dn <string>

LDAP Domain

--server1 <string>

LDAP server address

--user-attr <string>

Username attribute. Used to map a userid to LDAP to an LDAP dn.

Optional parameters:

--bind-dn <string>

LDAP Domain

--capath <string>

CA certificate to use for the server. The path can point to either a file, or a directory. If it points to a file, the PEM-formatted X.509 certificate stored at the path will be added as a trusted certificate. If the path points to a directory, the directory replaces the system's default certificate store at /etc/ssl/certs - Every file in the directory will be loaded as a trusted certificate.

--comment <string>

Comment.

--filter <string>

Custom LDAP search filter for user sync

--mode ldap|ldap+starttls|ldaps   (default=ldap)

LDAP connection type

--password <string>

LDAP bind password

--port <integer> (0 - 65535)

Port

--server2 <string>

Fallback LDAP server address

--sync-attributes [[email=<string>] [,firstname=<string>] [,lastname=<string>]]

Comma-separated list of key=value pairs for specifying which LDAP attributes map to which PBS user field. For example, to map the LDAP attribute mail to PBS's email, write email=mail.

--sync-defaults-options [[enable-new=<1|0>] [,remove-vanished=<string>]]

sync defaults options

--user-classes [<string>, ...]   (default=inetorgperson,posixaccount,person,user)

Comma-separated list of allowed objectClass values for user synchronization. For instance, if user-classes is set to person,user, then user synchronization will consider all LDAP entities where objectClass: person or objectClass: user.

--verify <boolean>   (default=false)

Verify server certificate


proxmox-backup-manager ldap delete <realm> [OPTIONS]

Remove an LDAP realm configuration

<realm><string>

Realm name.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager ldap list [OPTIONS]

List configured LDAP realms

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager ldap show <realm> [OPTIONS]

Show LDAP realm configuration

<realm><string>

Realm name.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager ldap sync <realm> [OPTIONS]

Sync a given LDAP realm

<realm><string>

Authentication domain ID

Optional parameters:

--dry-run <boolean>   (default=false)

If set, do not create/delete anything

--enable-new <boolean>

Enable newly synced users immediately

--remove-vanished [acl|entry|properties, ...]

A semicolon-separated list of things to remove when they or the user vanishes during user synchronization. The following values are possible: entry removes the user when not returned from the sync; properties removes any properties on existing user that do not appear in the source. acl removes ACLs when the user is not returned from the sync.


proxmox-backup-manager ldap update <realm> [OPTIONS]

Update an LDAP realm configuration

<realm><string>

Realm name.

Optional parameters:

--base-dn <string>

LDAP Domain

--bind-dn <string>

LDAP Domain

--capath <string>

CA certificate to use for the server. The path can point to either a file, or a directory. If it points to a file, the PEM-formatted X.509 certificate stored at the path will be added as a trusted certificate. If the path points to a directory, the directory replaces the system's default certificate store at /etc/ssl/certs - Every file in the directory will be loaded as a trusted certificate.

--comment <string>

Comment.

--delete server2|port|comment|verify|mode|bind-dn|password|filter|sync-defaults-options|sync-attributes|user-classes

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--filter <string>

Custom LDAP search filter for user sync

--mode ldap|ldap+starttls|ldaps   (default=ldap)

LDAP connection type

--password <string>

LDAP bind password

--port <integer> (0 - 65535)

Port

--server1 <string>

LDAP server address

--server2 <string>

Fallback LDAP server address

--sync-attributes [[email=<string>] [,firstname=<string>] [,lastname=<string>]]

Comma-separated list of key=value pairs for specifying which LDAP attributes map to which PBS user field. For example, to map the LDAP attribute mail to PBS's email, write email=mail.

--sync-defaults-options [[enable-new=<1|0>] [,remove-vanished=<string>]]

sync defaults options

--user-attr <string>

Username attribute. Used to map a userid to LDAP to an LDAP dn.

--user-classes [<string>, ...]   (default=inetorgperson,posixaccount,person,user)

Comma-separated list of allowed objectClass values for user synchronization. For instance, if user-classes is set to person,user, then user synchronization will consider all LDAP entities where objectClass: person or objectClass: user.

--verify <boolean>   (default=false)

Verify server certificate


proxmox-backup-manager network changes

Show pending configuration changes (diff)


proxmox-backup-manager network create <iface> [OPTIONS]

Create network interface configuration.

<iface><string>

Network interface name.

Optional parameters:

--autostart <boolean>

Autostart interface.

--bond-primary <string>

Network interface name.

--bond_mode balance-rr|active-backup|balance-xor|broadcast|802.3ad|balance-tlb|balance-alb

Linux Bond Mode

--bond_xmit_hash_policy layer2|layer2+3|layer3+4

Bond Transmit Hash Policy for LACP (802.3ad)

--bridge_ports [<string>, ...]

A list of network devices, comma separated.

--bridge_vlan_aware <boolean>

Enable bridge vlan support.

--cidr <string>

IPv4 address with netmask (CIDR notation).

--cidr6 <string>

IPv6 address with netmask (CIDR notation).

--comments <string>

Comments (inet, may span multiple lines)

--comments6 <string>

Comments (inet5, may span multiple lines)

--gateway <string>

IPv4 address.

--gateway6 <string>

IPv6 address.

--method manual|static|dhcp|loopback

Interface configuration method

--method6 manual|static|dhcp|loopback

Interface configuration method

--mtu <integer> (46 - 65535)   (default=1500)

Maximum Transmission Unit.

--slaves [<string>, ...]

A list of network devices, comma separated.

--type loopback|eth|bridge|bond|vlan|alias|unknown

Network interface type

--vlan-id <integer>

VLAN ID.

--vlan-raw-device <string>

Network interface name.


proxmox-backup-manager network list [OPTIONS]

Network device list.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager network reload

Reload network changes


proxmox-backup-manager network remove <iface> [OPTIONS]

Remove network interface configuration.

<iface><string>

Network interface name.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager network revert

Revert network configuration (rm /etc/network/interfaces.new).


proxmox-backup-manager network update <iface> [OPTIONS]

Update network interface config.

<iface><string>

Network interface name.

Optional parameters:

--autostart <boolean>

Autostart interface.

--bond-primary <string>

Network interface name.

--bond_mode balance-rr|active-backup|balance-xor|broadcast|802.3ad|balance-tlb|balance-alb

Linux Bond Mode

--bond_xmit_hash_policy layer2|layer2+3|layer3+4

Bond Transmit Hash Policy for LACP (802.3ad)

--bridge_ports [<string>, ...]

A list of network devices, comma separated.

--bridge_vlan_aware <boolean>

Enable bridge vlan support.

--cidr <string>

IPv4 address with netmask (CIDR notation).

--cidr6 <string>

IPv6 address with netmask (CIDR notation).

--comments <string>

Comments (inet, may span multiple lines)

--comments6 <string>

Comments (inet5, may span multiple lines)

--delete cidr|cidr6|gateway|gateway6|method|method6|comments|comments6|mtu|autostart|bridge_ports|bridge_vlan_aware|slaves|bond-primary|bond_xmit_hash_policy

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--gateway <string>

IPv4 address.

--gateway6 <string>

IPv6 address.

--method manual|static|dhcp|loopback

Interface configuration method

--method6 manual|static|dhcp|loopback

Interface configuration method

--mtu <integer> (46 - 65535)   (default=1500)

Maximum Transmission Unit.

--slaves [<string>, ...]

A list of network devices, comma separated.

--type loopback|eth|bridge|bond|vlan|alias|unknown

Network interface type

--vlan-id <integer>

VLAN ID.

--vlan-raw-device <string>

Network interface name.


proxmox-backup-manager node show [OPTIONS]

Show node configuration

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager node update [OPTIONS]

Update the node configuration

Optional parameters:

--acme [account=<string>]

The acme account to use on this node.

--acmedomain0 [domain=<string> [,alias=<string>] [,plugin=<string>]]

ACME domain configuration string

--acmedomain1 [domain=<string> [,alias=<string>] [,plugin=<string>]]

ACME domain configuration string

--acmedomain2 [domain=<string> [,alias=<string>] [,plugin=<string>]]

ACME domain configuration string

--acmedomain3 [domain=<string> [,alias=<string>] [,plugin=<string>]]

ACME domain configuration string

--acmedomain4 [domain=<string> [,alias=<string>] [,plugin=<string>]]

ACME domain configuration string

--ciphers-tls-1.2 <string>

OpenSSL cipher list used by the proxy for TLS <= 1.2

--ciphers-tls-1.3 <string>

OpenSSL ciphersuites list used by the proxy for TLS 1.3

--consent-text <string>

Consent banner text

--default-lang ar|ca|da|de|en|es|eu|fa|fr|gl|he|hu|it|ja|kr|nb|nl|nn|pl|pt_BR|ru|sl|sv|tr|zh_CN|zh_TW

All available languages in Proxmox. Taken from proxmox-i18n repository. pt_BR, zh_CN, and zh_TW use the same case in the translation files.

--delete acme|acmedomain0|acmedomain1|acmedomain2|acmedomain3|acmedomain4|http-proxy|email-from|ciphers-tls-1.3|ciphers-tls-1.2|default-lang|description|task-log-max-days|consent-text

List of properties to delete. Can be specified more than once.

--description <string>

Comment (multiple lines).

--digest <string>

Digest to protect against concurrent updates

--email-from <string>

E-Mail Address.

--http-proxy [http://]<host>[:port]

HTTP proxy configuration [http://]<host>[:port]

--task-log-max-days <integer> (0 - N)

Maximum days to keep Task logs




proxmox-backup-manager notification endpoint gotify create <name> --server <string> --token <string> [OPTIONS]

Add a new gotify endpoint.

<name><string>

Name schema for targets and matchers

--server <string>

Gotify Server URL.

--token <string>

Authentication token

Optional parameters:

--comment <string>

Comment.

--disable <boolean>

Disable this target.

--filter <string>

Deprecated.

--origin user-created|builtin|modified-builtin

The origin of a notification configuration entry.


proxmox-backup-manager notification endpoint gotify delete <name>

Delete gotify endpoint.

<name><string>

Name schema for targets and matchers


proxmox-backup-manager notification endpoint gotify list [OPTIONS]

List all endpoints.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification endpoint gotify show <name> [OPTIONS]

Show a single endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification endpoint gotify update <name> [OPTIONS]

Update gotify endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--comment <string>

Comment.

--delete comment|disable

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--disable <boolean>

Disable this target.

--server <string>

Gotify Server URL.

--token <string>

Authentication token


proxmox-backup-manager notification endpoint sendmail create <name> [OPTIONS]

Add a new sendmail endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--author <string>

Author of the mail. Defaults to 'Proxmox Backup Server ($hostname)'

--comment <string>

Comment.

--disable <boolean>

Disable this target.

--filter <string>

Deprecated.

--from-address <string>

From address for sent E-Mails. If the parameter is not set, the plugin will fall back to the email-from setting from node.cfg (PBS). If that is also not set, the plugin will default to root@$hostname, where $hostname is the hostname of the node.

--mailto <string>

Mail address to send a mail to. Can be specified more than once.

--mailto-user <string>

Users to send a mail to. The email address of the user will be looked up in users.cfg. Can be specified more than once.

--origin user-created|builtin|modified-builtin

The origin of a notification configuration entry.


proxmox-backup-manager notification endpoint sendmail delete <name>

Delete sendmail endpoint.

<name><string>

Name schema for targets and matchers


proxmox-backup-manager notification endpoint sendmail list [OPTIONS]

List all endpoints.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification endpoint sendmail show <name> [OPTIONS]

Show a single endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification endpoint sendmail update <name> [OPTIONS]

Update sendmail endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--author <string>

Author of the mail. Defaults to 'Proxmox Backup Server ($hostname)'

--comment <string>

Comment.

--delete author|comment|disable|from-address|mailto|mailto-user

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--disable <boolean>

Disable this target.

--from-address <string>

From address for sent E-Mails. If the parameter is not set, the plugin will fall back to the email-from setting from node.cfg (PBS). If that is also not set, the plugin will default to root@$hostname, where $hostname is the hostname of the node.

--mailto <string>

Mail address to send a mail to. Can be specified more than once.

--mailto-user <string>

Users to send a mail to. The email address of the user will be looked up in users.cfg. Can be specified more than once.


proxmox-backup-manager notification endpoint smtp create <name> --from-address <string> --server <string> [OPTIONS]

Add a new smtp endpoint.

<name><string>

Name schema for targets and matchers

--from-address <string>

From address for the mail. SMTP relays might require that this address is owned by the user in order to avoid spoofing. The From header in the email will be set to $author <$from-address>.

--server <string>

Host name or IP of the SMTP relay.

Optional parameters:

--author <string>

Author of the mail. Defaults to 'Proxmox Backup Server ($hostname)'

--comment <string>

Comment.

--disable <boolean>

Disable this target.

--mailto <string>

Mail address to send a mail to. Can be specified more than once.

--mailto-user <string>

Users to send a mail to. The email address of the user will be looked up in users.cfg. Can be specified more than once.

--mode insecure|starttls|tls   (default=tls)

Connection security

--origin user-created|builtin|modified-builtin

The origin of a notification configuration entry.

--password <string>

SMTP authentication password

--port <integer> (0 - 65535)

The port to connect to. If not set, the used port defaults to 25 (insecure), 465 (tls) or 587 (starttls), depending on the value of mode

--username <string>

Username to use during authentication. If no username is set, no authentication will be performed. The PLAIN and LOGIN authentication methods are supported


proxmox-backup-manager notification endpoint smtp delete <name>

Delete smtp endpoint.

<name><string>

Name schema for targets and matchers


proxmox-backup-manager notification endpoint smtp list [OPTIONS]

List all endpoints.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification endpoint smtp show <name> [OPTIONS]

Show a single endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification endpoint smtp update <name> [OPTIONS]

Update smtp endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--author <string>

Author of the mail. Defaults to 'Proxmox Backup Server ($hostname)'

--comment <string>

Comment.

--delete author|comment|disable|mailto|mailto-user|password|port|username

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--disable <boolean>

Disable this target.

--from-address <string>

From address for the mail. SMTP relays might require that this address is owned by the user in order to avoid spoofing. The From header in the email will be set to $author <$from-address>.

--mailto <string>

Mail address to send a mail to. Can be specified more than once.

--mailto-user <string>

Users to send a mail to. The email address of the user will be looked up in users.cfg. Can be specified more than once.

--mode insecure|starttls|tls   (default=tls)

Connection security

--password <string>

SMTP authentication password

--port <integer> (0 - 65535)

The port to connect to. If not set, the used port defaults to 25 (insecure), 465 (tls) or 587 (starttls), depending on the value of mode

--server <string>

Host name or IP of the SMTP relay.

--username <string>

Username to use during authentication. If no username is set, no authentication will be performed. The PLAIN and LOGIN authentication methods are supported


proxmox-backup-manager notification endpoint webhook create <name> --method post|put|get --url <string> [OPTIONS]

Add a new webhook endpoint.

<name><string>

Name schema for targets and matchers

--method post|put|get   (default=post)

HTTP Method to use.

--url <string>

HTTP(s) url with optional port.

Optional parameters:

--body <string>

The HTTP body to send. Supports templating.

--comment <string>

Comment.

--disable <boolean>

Disable this target.

--header [name=<string> [,value=<string>]]

Array of HTTP headers. Each entry is a property string with a name and a value. The value property contains the header in base64 encoding. Supports templating. Can be specified more than once.

--origin user-created|builtin|modified-builtin

The origin of a notification configuration entry.

--secret [name=<string> [,value=<string>]]

Array of secrets. Each entry is a property string with a name and an optional value. The value property contains the secret in base64 encoding. For any API endpoints returning the endpoint config, only the secret name but not the value will be returned. When updating the config, also send all secrets that you want to keep, setting only the name but not the value. Can be accessed from templates. Can be specified more than once.


proxmox-backup-manager notification endpoint webhook delete <name>

Delete webhook endpoint.

<name><string>

Name schema for targets and matchers


proxmox-backup-manager notification endpoint webhook list [OPTIONS]

List all endpoints.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification endpoint webhook show <name> [OPTIONS]

Show a single endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification endpoint webhook update <name> [OPTIONS]

Update webhook endpoint.

<name><string>

Name schema for targets and matchers

Optional parameters:

--body <string>

The HTTP body to send. Supports templating.

--comment <string>

Comment.

--delete comment|disable|header|body|secret

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--disable <boolean>

Disable this target.

--header [name=<string> [,value=<string>]]

Array of HTTP headers. Each entry is a property string with a name and a value. The value property contains the header in base64 encoding. Supports templating. Can be specified more than once.

--method post|put|get   (default=post)

HTTP Method to use.

--secret [name=<string> [,value=<string>]]

Array of secrets. Each entry is a property string with a name and an optional value. The value property contains the secret in base64 encoding. For any API endpoints returning the endpoint config, only the secret name but not the value will be returned. When updating the config, also send all secrets that you want to keep, setting only the name but not the value. Can be accessed from templates. Can be specified more than once.

--url <string>

HTTP(s) url with optional port.


proxmox-backup-manager notification matcher create <name> [OPTIONS]

Add a new notification matcher.

<name><string>

Name schema for targets and matchers

Optional parameters:

--comment <string>

Comment.

--disable <boolean>

Disable this matcher.

--invert-match <boolean>

Invert match of the whole filter.

--match-calendar <string>

List of matched severity levels. Can be specified more than once.

--match-field <string>

List of matched metadata fields. Can be specified more than once.

--match-severity <string>

List of matched severity levels. Can be specified more than once.

--mode all|any   (default=all)

The mode in which the results of matches are combined.

--origin user-created|builtin|modified-builtin

The origin of a notification configuration entry.

--target <string>

Targets to notify. Can be specified more than once.


proxmox-backup-manager notification matcher delete <name>

Delete notification matcher.

<name><string>

Name schema for targets and matchers


proxmox-backup-manager notification matcher list [OPTIONS]

List notification matchers.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification matcher show <name> [OPTIONS]

Show a single matcher.

<name><string>

Name schema for targets and matchers

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification matcher update <name> [OPTIONS]

Update notification matcher.

<name><string>

Name schema for targets and matchers

Optional parameters:

--comment <string>

Comment.

--delete comment|disable|invert-match|match-calendar|match-field|match-severity|mode|target

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--disable <boolean>

Disable this matcher.

--invert-match <boolean>

Invert match of the whole filter.

--match-calendar <string>

List of matched severity levels. Can be specified more than once.

--match-field <string>

List of matched metadata fields. Can be specified more than once.

--match-severity <string>

List of matched severity levels. Can be specified more than once.

--mode all|any   (default=all)

The mode in which the results of matches are combined.

--target <string>

Targets to notify. Can be specified more than once.


proxmox-backup-manager notification target list [OPTIONS]

List targets.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager notification target test <name>

Test a given notification target.

<name><string>

Name schema for targets and matchers


proxmox-backup-manager openid create <realm> --client-id <string> --issuer-url <string> [OPTIONS]

Create a new OpenId realm

<realm><string>

Realm name.

--client-id <string>

OpenID Client ID

--issuer-url <string>

OpenID Issuer Url

Optional parameters:

--acr-values [<string>, ...]

OpenID ACR List

--autocreate <boolean>   (default=false)

Automatically create users if they do not exist.

--client-key <string>

OpenID Client Key

--comment <string>

Comment.

--prompt <string>

OpenID Prompt

--scopes [<string>, ...]   (default=email profile)

OpenID Scope List

--username-claim <string>

Use the value of this attribute/claim as unique user name. It is up to the identity provider to guarantee the uniqueness. The OpenID specification only guarantees that Subject ('sub') is unique. Also make sure that the user is not allowed to change that attribute by himself!


proxmox-backup-manager openid delete <realm> [OPTIONS]

Remove a OpenID realm configuration

<realm><string>

Realm name.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager openid list [OPTIONS]

List configured OpenId realms

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager openid show <realm> [OPTIONS]

Show OpenID realm configuration

<realm><string>

Realm name.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager openid update <realm> [OPTIONS]

Update an OpenID realm configuration

<realm><string>

Realm name.

Optional parameters:

--acr-values [<string>, ...]

OpenID ACR List

--autocreate <boolean>   (default=false)

Automatically create users if they do not exist.

--client-id <string>

OpenID Client ID

--client-key <string>

OpenID Client Key

--comment <string>

Comment.

--delete client-key|comment|autocreate|scopes|prompt|acr-values

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--issuer-url <string>

OpenID Issuer Url

--prompt <string>

OpenID Prompt

--scopes [<string>, ...]   (default=email profile)

OpenID Scope List


proxmox-backup-manager prune-job create <id> --schedule <calendar-event> --store <string> [OPTIONS]

Create a new prune job.

<id><string>

Job ID.

--schedule <calendar-event>

Run prune job at specified schedule.

--store <string>

Datastore name.

Optional parameters:

--comment <string>

Comment.

--disable <boolean>   (default=false)

Disable this job.

--keep-daily <integer> (1 - N)

Number of daily backups to keep.

--keep-hourly <integer> (1 - N)

Number of hourly backups to keep.

--keep-last <integer> (1 - N)

Number of backups to keep.

--keep-monthly <integer> (1 - N)

Number of monthly backups to keep.

--keep-weekly <integer> (1 - N)

Number of weekly backups to keep.

--keep-yearly <integer> (1 - N)

Number of yearly backups to keep.

--max-depth <integer> (0 - 7)

How many levels of namespaces should be operated on (0 == no recursion, empty == automatic full recursion, namespace depths reduce maximum allowed value)

--ns <string>

Namespace.


proxmox-backup-manager prune-job list [OPTIONS]

List all prune jobs

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager prune-job remove <id> [OPTIONS]

Remove a prune job configuration

<id><string>

Job ID.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager prune-job run <id> [OPTIONS]

Run the specified prune job

<id><string>

Job ID.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager prune-job show <id> [OPTIONS]

Show prune job configuration

<id><string>

Job ID.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager prune-job update <id> [OPTIONS]

Update prune job config.

<id><string>

Job ID.

Optional parameters:

--comment <string>

Comment.

--delete comment|disable|ns|max-depth|keep-last|keep-hourly|keep-daily|keep-weekly|keep-monthly|keep-yearly

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--disable <boolean>   (default=false)

Disable this job.

--keep-daily <integer> (1 - N)

Number of daily backups to keep.

--keep-hourly <integer> (1 - N)

Number of hourly backups to keep.

--keep-last <integer> (1 - N)

Number of backups to keep.

--keep-monthly <integer> (1 - N)

Number of monthly backups to keep.

--keep-weekly <integer> (1 - N)

Number of weekly backups to keep.

--keep-yearly <integer> (1 - N)

Number of yearly backups to keep.

--max-depth <integer> (0 - 7)

How many levels of namespaces should be operated on (0 == no recursion, empty == automatic full recursion, namespace depths reduce maximum allowed value)

--ns <string>

Namespace.

--schedule <calendar-event>

Run prune job at specified schedule.

--store <string>

Datastore name.


proxmox-backup-manager pull <remote> <remote-store> <store> [OPTIONS]

Sync datastore by pulling from another repository

<remote><string>

Remote ID.

<remote-store><string>

Datastore name.

<store><string>

Datastore name.

Optional parameters:

--burst-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--burst-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--group-filter [<exclude:|include:>]<type:<vm|ct|host>|group:GROUP|regex:RE>

List of group filters. Can be specified more than once.

--max-depth <integer> (0 - 7)   (default=7)

How many levels of namespaces should be operated on (0 == no recursion)

--ns <string>

Namespace.

--output-format text|json|json-pretty

Output format.

--rate-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--rate-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--remote-ns <string>

Namespace.

--remove-vanished <boolean>   (default=false)

Delete vanished backups. This remove the local copy if the remote backup was deleted.

--resync-corrupt <boolean>

If the verification failed for a local snapshot, try to pull it again.

--transfer-last <integer> (1 - N)

Limit transfer to last N snapshots (per group), skipping others


proxmox-backup-manager push <store> <remote> <remote-store> [OPTIONS]

Sync datastore by pushing to another repository

<store><string>

Datastore name.

<remote><string>

Remote ID.

<remote-store><string>

Datastore name.

Optional parameters:

--burst-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--burst-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--group-filter [<exclude:|include:>]<type:<vm|ct|host>|group:GROUP|regex:RE>

List of group filters. Can be specified more than once.

--max-depth <integer> (0 - 7)   (default=7)

How many levels of namespaces should be operated on (0 == no recursion)

--ns <string>

Namespace.

--output-format text|json|json-pretty

Output format.

--rate-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--rate-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--remote-ns <string>

Namespace.

--remove-vanished <boolean>   (default=false)

Delete vanished backups. This remove the local copy if the remote backup was deleted.

--transfer-last <integer> (1 - N)

Limit transfer to last N snapshots (per group), skipping others


proxmox-backup-manager remote create <name> --auth-id <string> --host <string> --password <string> [OPTIONS]

Create new remote.

<name><string>

Remote ID.

--auth-id <string>

Authentication ID

--host <string>

DNS name or IP address.

--password <string>

Password or auth token for remote host.

Optional parameters:

--comment <string>

Comment.

--fingerprint <string>

X509 certificate fingerprint (sha256).

--port <integer>

The (optional) port


proxmox-backup-manager remote list [OPTIONS]

List configured remotes.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager remote remove <name> [OPTIONS]

Remove a remote from the configuration file.

<name><string>

Remote ID.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager remote show <name> [OPTIONS]

Show remote configuration

<name><string>

Remote ID.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager remote update <name> [OPTIONS]

Update remote configuration.

<name><string>

Remote ID.

Optional parameters:

--auth-id <string>

Authentication ID

--comment <string>

Comment.

--delete comment|fingerprint|port

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--fingerprint <string>

X509 certificate fingerprint (sha256).

--host <string>

DNS name or IP address.

--password <string>

Password or auth token for remote host.

--port <integer>

The (optional) port


proxmox-backup-manager report

System report


proxmox-backup-manager subscription get [OPTIONS]

Read subscription info.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager subscription remove

Delete subscription info.


proxmox-backup-manager subscription set <key>

Set a subscription key and check it.

<key><string>

Proxmox Backup Server subscription key.


proxmox-backup-manager subscription set-offline-key <data>

(Internal use only!) Set a signed subscription info blob as offline key

<data><string>

base64-encoded signed subscription info


proxmox-backup-manager subscription update [OPTIONS]

Check and update subscription status.

Optional parameters:

--force <boolean>   (default=false)

Always connect to server, even if information in cache is up to date.


proxmox-backup-manager sync-job create <id> --remote-store <string> --store <string> [OPTIONS]

Create a new sync job.

<id><string>

Job ID.

--remote-store <string>

Datastore name.

--store <string>

Datastore name.

Optional parameters:

--burst-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--burst-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--comment <string>

Comment.

--group-filter [<exclude:|include:>]<type:<vm|ct|host>|group:GROUP|regex:RE>

List of group filters. Can be specified more than once.

--max-depth <integer> (0 - 7)

How many levels of namespaces should be operated on (0 == no recursion, empty == automatic full recursion, namespace depths reduce maximum allowed value)

--ns <string>

Namespace.

--owner <string>

Authentication ID

--rate-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--rate-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--remote <string>

Remote ID.

--remote-ns <string>

Namespace.

--remove-vanished <boolean>   (default=false)

Delete vanished backups. This remove the local copy if the remote backup was deleted.

--resync-corrupt <boolean>

If the verification failed for a local snapshot, try to pull it again.

--schedule <calendar-event>

Run sync job at specified schedule.

--sync-direction pull|push   (default=pull)

Direction of the sync job, push or pull

--transfer-last <integer> (1 - N)

Limit transfer to last N snapshots (per group), skipping others


proxmox-backup-manager sync-job list [OPTIONS]

Sync job list.

Optional parameters:

--output-format text|json|json-pretty

Output format.

--sync-direction all|push|pull   (default=pull)

The direction of the listed sync jobs: push, pull or all.


proxmox-backup-manager sync-job remove <id> [OPTIONS]

Remove a sync job configuration

<id><string>

Job ID.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager sync-job run <id> [OPTIONS]

Run the specified sync job

<id><string>

Job ID.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager sync-job show <id> [OPTIONS]

Show sync job configuration

<id><string>

Job ID.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager sync-job update <id> [OPTIONS]

Update sync job config.

<id><string>

Job ID.

Optional parameters:

--burst-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--burst-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--comment <string>

Comment.

--delete remote|owner|comment|schedule|remove-vanished|group-filter|rate-in|burst-in|rate-out|burst-out|ns|remote-ns|max-depth|transfer-last|sync-direction

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--group-filter [<exclude:|include:>]<type:<vm|ct|host>|group:GROUP|regex:RE>

List of group filters. Can be specified more than once.

--max-depth <integer> (0 - 7)

How many levels of namespaces should be operated on (0 == no recursion, empty == automatic full recursion, namespace depths reduce maximum allowed value)

--ns <string>

Namespace.

--owner <string>

Authentication ID

--rate-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--rate-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--remote <string>

Remote ID.

--remote-ns <string>

Namespace.

--remote-store <string>

Datastore name.

--remove-vanished <boolean>   (default=false)

Delete vanished backups. This remove the local copy if the remote backup was deleted.

--resync-corrupt <boolean>

If the verification failed for a local snapshot, try to pull it again.

--schedule <calendar-event>

Run sync job at specified schedule.

--store <string>

Datastore name.

--sync-direction pull|push   (default=pull)

Direction of the sync job, push or pull

--transfer-last <integer> (1 - N)

Limit transfer to last N snapshots (per group), skipping others


proxmox-backup-manager task list [OPTIONS]

List running server tasks.

Optional parameters:

--all <boolean>

Also list stopped tasks.

--limit <integer> (1 - 1000)   (default=50)

The maximal number of tasks to list.

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager task log <upid>

Display the task log.

<upid><string>

Unique Process/Task Identifier


proxmox-backup-manager task stop <upid>

Try to stop a specific task.

<upid><string>

Unique Process/Task Identifier


proxmox-backup-manager traffic-control create <name> --network <string> [OPTIONS]

Create new traffic control rule.

<name><string>

Rule ID.

--network <string>

Rule applies to Source IPs within this networks Can be specified more than once.

Optional parameters:

--burst-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--burst-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--comment <string>

Comment.

--rate-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--rate-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--timeframe <string>

Enable the rule at specific times Can be specified more than once.


proxmox-backup-manager traffic-control list [OPTIONS]

List configured traffic control rules.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager traffic-control remove <name> [OPTIONS]

Remove a traffic control rule from the configuration file.

<name><string>

Rule ID.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager traffic-control show <name> [OPTIONS]

Show traffic control configuration

<name><string>

Rule ID.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager traffic-control traffic [OPTIONS]

Show current traffic for all rules.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager traffic-control update <name> [OPTIONS]

Update traffic control configuration.

<name><string>

Rule ID.

Optional parameters:

--burst-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--burst-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--comment <string>

Comment.

--delete rate-in|burst-in|rate-out|burst-out|comment|timeframe

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--network <string>

Rule applies to Source IPs within this networks Can be specified more than once.

--rate-in <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--rate-out <string>

Byte size with optional unit (B, KB (base 10), MB, GB, ..., KiB (base 2), MiB, Gib, ...).

--timeframe <string>

Enable the rule at specific times Can be specified more than once.


proxmox-backup-manager user create <userid> [OPTIONS]

Create new user.

<userid><string>

User ID

Optional parameters:

--comment <string>

Comment.

--email <string>

E-Mail Address.

--enable <boolean>   (default=true)

Enable the account (default). You can set this to '0' to disable the account.

--expire <integer> (0 - N)   (default=0)

Account expiration date (seconds since epoch). '0' means no expiration date.

--firstname <string>

First name.

--lastname <string>

Last name.

--password <string>

User Password.


proxmox-backup-manager user delete-token <userid> <token-name> [OPTIONS]

Delete a user's API token

<userid><string>

User ID

<token-name><string>

The token ID part of an API token authentication id.

This alone does NOT uniquely identify the API token - use a full Authid for such use cases.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager user generate-token <userid> <token-name> [OPTIONS]

Generate a new API token with given metadata

<userid><string>

User ID

<token-name><string>

The token ID part of an API token authentication id.

This alone does NOT uniquely identify the API token - use a full Authid for such use cases.

Optional parameters:

--comment <string>

Comment.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--enable <boolean>   (default=true)

Enable the account (default). You can set this to '0' to disable the account.

--expire <integer> (0 - N)   (default=0)

Account expiration date (seconds since epoch). '0' means no expiration date.


proxmox-backup-manager user list [OPTIONS]

List configured users.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager user list-tokens <userid> [OPTIONS]

List tokens associated with user.

<userid><string>

User ID

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager user permissions <auth-id> [OPTIONS]

List permissions of user/token.

<auth-id><string>

Authentication ID

Optional parameters:

--output-format text|json|json-pretty

Output format.

--path <string>

Access control path.


proxmox-backup-manager user remove <userid> [OPTIONS]

Remove a user from the configuration file.

<userid><string>

User ID

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager user tfa delete <userid> <id> [OPTIONS]

Delete a single TFA entry.

<userid><string>

User ID

<id><string>

the tfa entry id

Optional parameters:

--password <string>

Password.


proxmox-backup-manager user tfa list <userid> [OPTIONS]

List all tfa methods for a user.

<userid><string>

User ID

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager user tfa unlock <userid>

Unlock a user's TFA authentication.

<userid><string>

User ID


proxmox-backup-manager user update <userid> [OPTIONS]

Update user configuration. To change a user's password use the 'PUT /access/password' endpoint.

<userid><string>

User ID

Optional parameters:

--comment <string>

Comment.

--delete comment|firstname|lastname|email

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--email <string>

E-Mail Address.

--enable <boolean>   (default=true)

Enable the account (default). You can set this to '0' to disable the account.

--expire <integer> (0 - N)   (default=0)

Account expiration date (seconds since epoch). '0' means no expiration date.

--firstname <string>

First name.

--lastname <string>

Last name.

--password <string>

This parameter is ignored, please use 'PUT /access/password' to change a user's password


proxmox-backup-manager verify <store> [OPTIONS]

Verify backups

<store><string>

Datastore name.

Optional parameters:

--ignore-verified <boolean>   (default=true)

Do not verify backups that are already verified if their verification is not outdated.

--outdated-after <integer> (0 - N)

Days after that a verification becomes outdated. (0 is deprecated)'

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager verify-job create <id> --store <string> [OPTIONS]

Create a new verification job.

<id><string>

Job ID.

--store <string>

Datastore name.

Optional parameters:

--comment <string>

Comment.

--ignore-verified <boolean>   (default=true)

Do not verify backups that are already verified if their verification is not outdated.

--max-depth <integer> (0 - 7)   (default=7)

How many levels of namespaces should be operated on (0 == no recursion)

--ns <string>

Namespace.

--outdated-after <integer> (0 - N)

Days after that a verification becomes outdated. (0 is deprecated)'

--schedule <calendar-event>

Run verify job at specified schedule.


proxmox-backup-manager verify-job list [OPTIONS]

List all verification jobs

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager verify-job remove <id> [OPTIONS]

Remove a verification job configuration

<id><string>

Job ID.

Optional parameters:

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.


proxmox-backup-manager verify-job run <id> [OPTIONS]

Run the specified verification job

<id><string>

Job ID.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager verify-job show <id> [OPTIONS]

Show verification job configuration

<id><string>

Job ID.

Optional parameters:

--output-format text|json|json-pretty

Output format.


proxmox-backup-manager verify-job update <id> [OPTIONS]

Update verification job config.

<id><string>

Job ID.

Optional parameters:

--comment <string>

Comment.

--delete ignore-verified|comment|schedule|outdated-after|ns|max-depth

List of properties to delete. Can be specified more than once.

--digest <string>

Prevent changes if current configuration file has different SHA256 digest. This can be used to prevent concurrent modifications.

--ignore-verified <boolean>   (default=true)

Do not verify backups that are already verified if their verification is not outdated.

--max-depth <integer> (0 - 7)   (default=7)

How many levels of namespaces should be operated on (0 == no recursion)

--ns <string>

Namespace.

--outdated-after <integer> (0 - N)

Days after that a verification becomes outdated. (0 is deprecated)'

--schedule <calendar-event>

Run verify job at specified schedule.

--store <string>

Datastore name.


proxmox-backup-manager versions [OPTIONS]

List package versions for important Proxmox Backup Server packages.

Optional parameters:

--output-format text|json|json-pretty

Output format.

--verbose <boolean>   (default=false)

Output verbose package information. It is ignored if output-format is specified.

Description

This tool exposes the whole backup server management API on the command line.