Percona Server for MongoDB README

July 16, 2025 ยท View on GitHub

Welcome to Percona Server for MongoDB!

Percona Server for MongoDB is a source-available, enterprise-grade drop-in replacement for MongoDB Community Edition.

Components

  • mongod - The database server.
  • mongos - Sharding router.
  • mongo - The database shell (uses interactive javascript).
  • tools
    • bsondump
    • mongodump
    • mongorestore
    • mongoexport
    • mongostat
    • perconadecrypt

Documentation

Installation

Use Installing Percona Server for MongoDB to navigate to the required installation instructions.

Running

For command line options invoke:

$ ./mongod --help

To run a single server database:

$ sudo mkdir -p /data/db
$ ./mongod
$
$ # The mongosh shell connects to localhost and test database by default:
$ ./mongosh
test> help

Drivers

Client drivers for most programming languages are available at https://docs.mongodb.com/manual/applications/drivers/.

Packaging

Packages for Percona Server for MongoDB are created by Percona team and are available at Percona website.

Community

Find answers to MongoDB-related questions on Percona Server for MongoDB Forum.

Get insights about MongoDB from experts in the industry on Percona Database Performance Blog.

Submitting bug reports or feature requests

If you find a bug in Percona Server for MongoDB, you can submit a report to the JIRA issue tracker for Percona Server for MongoDB: https://jira.percona.com/projects/PSMDB

Start by searching the open tickets in Percona's JIRA or MongoDB's Jira for a similar report. If you find that someone else has already reported your problem, then you can upvote that report to increase its visibility.

If there is no existing report, submit a report following these steps:

  1. Sign in to JIRA issue tracker. You will need to create an account if you do not have one.
  2. In the Summary, Description, Steps To Reproduce, Affects Version fields describe the problem you have detected.
  3. As a general rule of thumb, try to create bug reports that are:
    • Reproducible: describe the steps to reproduce the problem.
    • Specific: include the version of Percona Server for MongoDB, your environment, and so on.
    • Unique: check if there already exists a JIRA ticket to describe the problem.
    • Scoped to a Single Bug: only report one bug in one JIRA ticket.

LICENSE

Percona Server for MongoDB is source-available software.