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` `<string>` ::
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 `--notify` `<always | error | never>` ::
153 Specify when to notify via e-mail
155 `--password` `<password>` ::
157 Password or API token secret for the user on the Proxmox Backup Server.
159 `--server` `<string>` ::
161 Proxmox Backup Server address.
163 `--username` `(?:[^\s\\@]+\@[^\s\/\\@]+)` ::
165 Username or API token ID on the Proxmox Backup Server
167 *pmgbackup proxmox-backup remote list* `[FORMAT_OPTIONS]`
169 List all configured Proxmox Backup Server instances.
171 *pmgbackup proxmox-backup remote remove* `<remote>`
175 `<remote>`: `<string>` ::
179 *pmgbackup proxmox-backup remote set* `<remote>` `[OPTIONS]`
181 Update PBS remote settings.
183 `<remote>`: `<string>` ::
185 Proxmox Backup Server ID.
187 `--datastore` `<string>` ::
189 Proxmox Backup Server datastore name.
191 `--delete` `<string>` ::
193 A list of settings you want to delete.
195 `--digest` `<string>` ::
197 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
199 `--disable` `<boolean>` ::
201 Flag to disable (deactivate) the entry.
203 `--fingerprint` `([A-Fa-f0-9]{2}:){31}[A-Fa-f0-9]{2}` ::
205 Certificate SHA 256 fingerprint.
207 `--include-statistics` `<boolean>` ::
209 Include statistics in scheduled backups
211 `--keep-daily` `<N>` ::
213 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.
215 `--keep-hourly` `<N>` ::
217 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.
219 `--keep-last` `<N>` ::
221 Keep the last <N> backups.
223 `--keep-monthly` `<N>` ::
225 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.
227 `--keep-weekly` `<N>` ::
229 Keep backups for the last <N> different weeks. If there ismore than one backup for a single week, only the latest one is kept.
231 `--keep-yearly` `<N>` ::
233 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.
235 `--notify` `<always | error | never>` ::
237 Specify when to notify via e-mail
239 `--password` `<password>` ::
241 Password or API token secret for the user on the Proxmox Backup Server.
243 `--server` `<string>` ::
245 Proxmox Backup Server address.
247 `--username` `(?:[^\s\\@]+\@[^\s\/\\@]+)` ::
249 Username or API token ID on the Proxmox Backup Server
251 *pmgbackup proxmox-backup restore* `<remote> <backup-id> <backup-time>` `[OPTIONS]`
253 Restore the system configuration.
255 `<remote>`: `<string>` ::
257 Proxmox Backup Server ID.
259 `<backup-id>`: `<string>` ::
261 backup-id (hostname) of backup snapshot
263 `<backup-time>`: `<string>` ::
265 backup-time to restore
267 `--config` `<boolean>` ('default =' `0`)::
269 Restore system configuration.
271 `--database` `<boolean>` ('default =' `1`)::
273 Restore the rule database. This is the default.
275 `--statistic` `<boolean>` ('default =' `0`)::
277 Restore statistic databases. Only considered when you restore the 'database'.
279 *pmgbackup restore* `--filename <string>` `[OPTIONS]`
281 Restore the system configuration.
283 `--config` `<boolean>` ('default =' `0`)::
285 Restore system configuration.
287 `--database` `<boolean>` ('default =' `1`)::
289 Restore the rule database. This is the default.
291 `--filename` `pmg-backup_[0-9A-Za-z_-]+\.tgz` ::
293 The backup file name.
295 `--statistic` `<boolean>` ('default =' `0`)::
297 Restore statistic databases. Only considered when you restore the 'database'.