Skip to content

Quickstart guide

Percona Backup for MongoDB (PBM) is an open source and distributed solution for consistent backups and restore of MongoDB sharded clusters and replica sets. Learn how PBM works.

Find the list of supported platforms for Percona Backup for MongoDB on the Percona Software and Platform Lifecycle page.

System requirements

  • At least 1GB RAM is required on every node for pbm-agents to operate successfully.
  • All pbm-agents in the cluster must be able to connect to all config server replica set nodes that could become a new primary. In non-sharded replica set deployments, this means to connect to all the nodes that could become a new primary node. To become a primary, a node must meet the following criteria:

    • have priority greater than 0 and must be able to vote (votes: 1)
    • is not an arbiter (arbiterOnly: false)
    • is not hidden (hidden: false)
    • is not delayed
  • All pbm-agents in your deployment must be able to connect to the same remote backup storage using the same credentials.

Note that networking issues like connection to the remote backup storage can also affect PBM performance.


You can use any of the easy-install guides but we recommend using the package manager of your operating system for a convenient and quick way to try the software first.

Use the package manager of your operating system to install Percona Backup for MongoDB:

  • apt - for Debian and Ubuntu Linux
  • yum - for Red Hat Enterprise Linux and compatible Linux derivatives

Install from repositories

Get our Docker image and spin up PBM for a quick evaluation.

Check the Docker guide for step-by-step guidelines.

Run in Docker

Percona Operator for Kubernetes is a controller introduced to simplify complex deployments that require meticulous and secure database expertise.

Check the Quickstart guides how to deploy and run PBM on Kubernetes with Percona Operator for MongoDB.

Deploy in Kubernetes Quickstart

Have a full control over the installation by building PBM from source code.

Check the guide below for step-by-step instructions.

Build from source

If you need to install PBM offline or prefer a specific version of it, check out the link below for a step-by-step guide and get access to the downloads directory.

Install from tarballs

Next steps

Initial setup

Get expert help

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Last update: April 15, 2024
Created: April 15, 2024