Build from source code

Before you start

Check the system requirements and known limitations.

Prerequisites

To build Percona ClusterSync for MongoDB from source, you need the following:

• Go 1.24 or later. Install and set up Go tools x
• make
• git

Build steps

Here’s how to build Percona ClusterSync for MongoDB:

1. Clone the repository and change directory to pcsm:

   git clone https://github.com/percona/percona-clustersync-mongodb.git
   $ cd pcsm
   

2. Build the project using the Makefile:

   $ make build
   

   Alternatively, you can install PCSM from the cloned repo using go install:

   $ go install .
   

   This installs pcsm into your GOBIN directory.

3. Add GOBIN to your PATH. This makes pcsm a global command in your terminal.

Next steps

Configure authentication

---

Last update: January 13, 2026
Created: January 13, 2026