Supported MongoDB versions¶
Percona Backup for MongoDB is compatible with:
- MongoDB Community / Enterprise Edition with MongoDB Replication enabled. Percona Backup for MongoDB supports only logical backups.
- Percona Server for MongoDB for all supported backup types. For logical backups, make sure MongoDB Replication is enabled. For physical and incremental backups, make sure WiredTiger is set as the storage engine.
Refer to the compatibility matrices below to check which MongoDB versions your current PBM release supports for backups and restores.
End-of-life MongoDB versions may work with PBM, but they are not tested for compatibility. Consider upgrading to the newer MongoDB or Percona Server for MongoDB version.
Percona Server for MongoDB compatibility matrix¶
The following table lists the Percona Server for MongoDB versions supported for each backup type.
Each entry indicates the PBM version that introduces changes in the supported Percona Server for MongoDB versions.
The Restore compatibility column indicates if you can restore from the backup made with the previous version of PBM.
| PBM version | Logical | Physical | Incremental physical | Restore backward compatibility |
|---|---|---|---|---|
| 2.8.0 - 2.9.0 | 6.0.x, 7.0.x, 8.0.x | 6.0.x, 7.0.x, 8.0.x | 6.0.x, 7.0.x, 8.0.x | Yes |
| 2.6.0 - 2.7.0 | 5.0.x, 6.0.x, 7.0.x | 5.0.x, 6.0.x, 7.0.x | 5.0.14-12, 6.0.3-2 and higher, 7.0.x | Yes |
| 2.2.0 - 2.5.0 | 4.4.x and higher | 4.4.6-8 and higher, 5.0.x, 6.0.x | 4.4.18-18, 5.0.14-12, 6.0.3-2 and higher | Yes |
| 2.1.0 | 4.4.x and higher | 4.4.6-8, 5.0.x, 6.0.x | 4.2.24-24, 4.4.18-18, 5.0.14-12, 6.0.3-2 and higher | No. A fresh backup is required |
| 1.7.0 | 4.2 and higher | tech preview: 4.2.15-16, 4.4.6-8, 5.0 and higher | Yes | |
| 1.6.1 | 3.6 and higher | N/A | N/A | N/A |
MongoDB Community / Enterprise Edition compatibility matrix¶
This table lists the supported MongoDB Community and Enterprise Edition versions for logical backups. Each entry indicates the new PBM version that introduces changes in the supported MongoDB versions.
The Restore compatibility column indicates if you can restore from the backup made with the previous version of PBM.
| PBM version | Logical backups | Restore backward compatibility |
|---|---|---|
| 2.8.0 - 2.9.0 | 6.0.x and higher | Yes |
| 2.6.0 - 2.7.0 | 5.0.x and higher | Yes |
| 2.2.0 - 2.5.0 | 4.4.x and higher | Yes |
| 2.1.0 | 4.4.x and higher | No. A fresh backup is required |
| 1.7.0 | 4.2 and higher | Yes |
| 1.6.1 | 3.6 and higher | Yes |
Created: April 11, 2025