1 *pmgbackup* `<COMMAND> [ARGS] [OPTIONS]`
3 *pmgbackup backup* `[OPTIONS]`
5 Backup the system configuration.
7 `--notify` `<always | error | never>` ('default =' `never`)::
9 Specify when to notify via e-mail
11 `--statistic` `<boolean>` ('default =' `1`)::
13 Backup statistic databases.
15 *pmgbackup help* `[OPTIONS]`
17 Get help about specified command.
19 `--extra-args` `<array>` ::
21 Shows help for a specific command
23 `--verbose` `<boolean>` ::
25 Verbose output format.
29 List all stored backups (files named proxmox-backup_{DATE}.tgz).
31 *pmgbackup proxmox-backup backup* `<remote>` `[OPTIONS]`
33 Create a new backup and prune the backup group afterwards, if configured.
35 `<remote>`: `<string>` ::
37 Proxmox Backup Server ID.
39 `--notify` `<always | error | never>` ('default =' `never`)::
41 Specify when to notify via e-mail
43 `--statistic` `<boolean>` ('default =' `1`)::
45 Backup statistic databases.
47 *pmgbackup proxmox-backup forget* `<remote> <backup-id> <backup-time>`
51 `<remote>`: `<string>` ::
53 Proxmox Backup Server ID.
55 `<backup-id>`: `<string>` ::
57 ID (hostname) of backup snapshot
59 `<backup-time>`: `<string>` ::
61 Backup time in RFC 3339 format
63 *pmgbackup proxmox-backup job create* `<remote>` `[OPTIONS]`
65 Create backup schedule
67 `<remote>`: `<string>` ::
69 Proxmox Backup Server ID.
71 `--delay` `[0-9a-zA-Z. ]+` ('default =' `5min`)::
73 Randomized delay to add to the starttime (RandomizedDelaySec setting of the systemd.timer)
75 `--schedule` `[0-9a-zA-Z*.:,\-/ ]+` ('default =' `daily`)::
77 Schedule for the backup (OnCalendar setting of the systemd.timer)
79 *pmgbackup proxmox-backup job delete* `<remote>`
81 Delete backup schedule
83 `<remote>`: `<string>` ::
85 Proxmox Backup Server ID.
87 *pmgbackup proxmox-backup job show* `<remote>` `[FORMAT_OPTIONS]`
89 Get timer specification
91 `<remote>`: `<string>` ::
93 Proxmox Backup Server ID.
95 *pmgbackup proxmox-backup list* `<remote>` `[FORMAT_OPTIONS]`
97 Get snapshots stored on remote.
99 `<remote>`: `<string>` ::
101 Proxmox Backup Server ID.
103 *pmgbackup proxmox-backup remote add* `<remote> --datastore <string> --server <string>` `[OPTIONS]`
105 Add Proxmox Backup Server remote instance.
107 `<remote>`: `<string>` ::
109 Proxmox Backup Server ID.
111 `--datastore` `(?:[A-Za-z0-9_][A-Za-z0-9._\-]*)` ::
113 Proxmox Backup Server datastore name.
115 `--disable` `<boolean>` ::
117 Flag to disable (deactivate) the entry.
119 `--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
121 Certificate SHA 256 fingerprint.
123 `--include-statistics` `<boolean>` ::
125 Include statistics in scheduled backups
127 `--keep-daily` `<N>` ::
129 Keep backups for the last <N> different days. If there is more than one backup for a single day, only the latest one is kept.
131 `--keep-hourly` `<N>` ::
133 Keep backups for the last <N> different hours. If there is more than one backup for a single hour, only the latest one is kept.
135 `--keep-last` `<N>` ::
137 Keep the last <N> backups.
139 `--keep-monthly` `<N>` ::
141 Keep backups for the last <N> different months. If there is more than one backup for a single month, only the latest one is kept.
143 `--keep-weekly` `<N>` ::
145 Keep backups for the last <N> different weeks. If there ismore than one backup for a single week, only the latest one is kept.
147 `--keep-yearly` `<N>` ::
149 Keep backups for the last <N> different years. If there is more than one backup for a single year, only the latest one is kept.
151 `--namespace` `(?:(?:[A-Za-z0-9_][A-Za-z0-9._\-]*)/){0,7}(?:(?:[A-Za-z0-9_][A-Za-z0-9._\-]*))?` ::
153 Proxmox Backup Server namespace in the datastore, defaults to the root NS.
155 `--notify` `<always | error | never>` ::
157 Specify when to notify via e-mail
159 `--password` `<password>` ::
161 Password or API token secret for the user on the Proxmox Backup Server.
163 `--port` `<integer> (1 - 65535)` ('default =' `8007`)::
165 Non-default port for Proxmox Backup Server.
167 `--server` `<string>` ::
169 Proxmox Backup Server address.
171 `--username` `(?:[^\s\\@]+\@[^\s\/\\@]+)` ::
173 Username or API token ID on the Proxmox Backup Server
175 *pmgbackup proxmox-backup remote list* `[FORMAT_OPTIONS]`
177 List all configured Proxmox Backup Server instances.
179 *pmgbackup proxmox-backup remote remove* `<remote>`
183 `<remote>`: `<string>` ::
187 *pmgbackup proxmox-backup remote set* `<remote>` `[OPTIONS]`
189 Update PBS remote settings.
191 `<remote>`: `<string>` ::
193 Proxmox Backup Server ID.
195 `--datastore` `(?:[A-Za-z0-9_][A-Za-z0-9._\-]*)` ::
197 Proxmox Backup Server datastore name.
199 `--delete` `<string>` ::
201 A list of settings you want to delete.
203 `--digest` `<string>` ::
205 Prevent changes if current configuration file has a different digest. This can be used to prevent concurrent modifications.
207 `--disable` `<boolean>` ::
209 Flag to disable (deactivate) the entry.
211 `--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
213 Certificate SHA 256 fingerprint.
215 `--include-statistics` `<boolean>` ::
217 Include statistics in scheduled backups
219 `--keep-daily` `<N>` ::
221 Keep backups for the last <N> different days. If there is more than one backup for a single day, only the latest one is kept.
223 `--keep-hourly` `<N>` ::
225 Keep backups for the last <N> different hours. If there is more than one backup for a single hour, only the latest one is kept.
227 `--keep-last` `<N>` ::
229 Keep the last <N> backups.
231 `--keep-monthly` `<N>` ::
233 Keep backups for the last <N> different months. If there is more than one backup for a single month, only the latest one is kept.
235 `--keep-weekly` `<N>` ::
237 Keep backups for the last <N> different weeks. If there ismore than one backup for a single week, only the latest one is kept.
239 `--keep-yearly` `<N>` ::
241 Keep backups for the last <N> different years. If there is more than one backup for a single year, only the latest one is kept.
243 `--namespace` `(?:(?:[A-Za-z0-9_][A-Za-z0-9._\-]*)/){0,7}(?:(?:[A-Za-z0-9_][A-Za-z0-9._\-]*))?` ::
245 Proxmox Backup Server namespace in the datastore, defaults to the root NS.
247 `--notify` `<always | error | never>` ::
249 Specify when to notify via e-mail
251 `--password` `<password>` ::
253 Password or API token secret for the user on the Proxmox Backup Server.
255 `--port` `<integer> (1 - 65535)` ('default =' `8007`)::
257 Non-default port for Proxmox Backup Server.
259 `--server` `<string>` ::
261 Proxmox Backup Server address.
263 `--username` `(?:[^\s\\@]+\@[^\s\/\\@]+)` ::
265 Username or API token ID on the Proxmox Backup Server
267 *pmgbackup proxmox-backup restore* `<remote> <backup-id> <backup-time>` `[OPTIONS]`
269 Restore the system configuration.
271 `<remote>`: `<string>` ::
273 Proxmox Backup Server ID.
275 `<backup-id>`: `<string>` ::
277 backup-id (hostname) of backup snapshot
279 `<backup-time>`: `<string>` ::
281 backup-time to restore
283 `--config` `<boolean>` ('default =' `0`)::
285 Restore system configuration.
287 `--database` `<boolean>` ('default =' `1`)::
289 Restore the rule database. This is the default.
291 `--statistic` `<boolean>` ('default =' `0`)::
293 Restore statistic databases. Only considered when you restore the 'database'.
295 *pmgbackup restore* `--filename <string>` `[OPTIONS]`
297 Restore the system configuration.
299 `--config` `<boolean>` ('default =' `0`)::
301 Restore system configuration.
303 `--database` `<boolean>` ('default =' `1`)::
305 Restore the rule database. This is the default.
307 `--filename` `pmg-backup_[0-9A-Za-z_-]+\.tgz` ::
309 The backup file name.
311 `--statistic` `<boolean>` ('default =' `0`)::
313 Restore statistic databases. Only considered when you restore the 'database'.