sync.cfg(5)
| SYNC.CFG(5) | Proxmox Backup | SYNC.CFG(5) |
NAME
sync.cfg - Synchronization Job Configuration
DESCRIPTION
The file /etc/proxmox-backup/sync.cfg is a configuration file for Proxmox Backup Server. It contains the synchronization job configuration.
FILE FORMAT
Each entry starts with the header sync: <name>, followed by the job configuration options.
sync: job1
store store1
remote-store store1
remote lina sync: ...
You can use the proxmox-backup-manager sync-job command to manipulate this file.
OPTIONS
Required properties:
- remote-store
- <string> Datastore name.
- store
- <string> Datastore name.
Optional properties:
- 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
- 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.
- schedule
- <calendar-event> Run sync job at specified schedule.
- transfer-last
- <integer> (1 - N) Limit transfer to last N snapshots (per group), skipping others
- 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, ...).
- 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, ...).
COPYRIGHT AND DISCLAIMER
Copyright (C) 2019-2023, Proxmox Server Solutions GmbH
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/
AUTHOR
Proxmox Support Team
COPYRIGHT
2019-2025, Proxmox Server Solutions GmbH
| Wednesday, 24 December 2025 | <devbuild> |