133 lines (85 sloc) 3.44 KB

Building MongoDB

To build MongoDB, you will need:

  • A modern C++ compiler. One of the following is required.
    • GCC 5.4.0 or newer
    • Clang 3.8 (or Apple XCode 8.3.2 Clang) or newer
    • Visual Studio 2015 Update 3 or newer (See Windows section below for details)
  • Python 2.7.x and Pip modules:
    • pyyaml
    • typing

MongoDB supports the following architectures: arm64, ppc64le, s390x, and x86-64. More detailed platform instructions can be found below.

MongoDB Tools

The MongoDB command line tools (mongodump, mongorestore, mongoimport, mongoexport, etc) have been rewritten in Go and are no longer included in this repository.

The source for the tools is now available at mongodb/mongo-tools.

Python Prerequisites

In order to build MongoDB, Python 2.7.x is required, and several Python modules. To install the required Python modules, run:

$ pip2 install -r buildscripts/requirements.txt

Note: If the pip2 command is not available, pip without a suffix may be the pip command associated with Python 2.7.x.


For detail information about building, please see the build manual

If you want to build everything (mongod, mongo, tests, etc):

$ python2 buildscripts/ all

If you only want to build the database:

$ python2 buildscripts/ scons

To install

$ python2 buildscripts/ --prefix=/opt/mongo install

Please note that prebuilt binaries are available on and may be the easiest way to get started.

SCons Targets

  • mongod
  • mongos
  • mongo
  • core (includes mongod, mongos, mongo)
  • all


See the windows build manual

Build requirements:

  • Visual Studio 2015 Update 2 or newer
  • Python 2.7, ActiveState ActivePython 2.7.x Community Edition for Windows is recommended

If using VS 2015 Update 3, two hotfixes are required to build. For details, see:

Or download a prebuilt binary for Windows at


To install dependencies on Debian or Ubuntu systems:

# aptitude install build-essential
# aptitude install libboost-filesystem-dev libboost-program-options-dev libboost-system-dev libboost-thread-dev

To run tests as well, you will need PyMongo:

# aptitude install python-pymongo


Using Homebrew:

$ brew install mongodb

Using MacPorts:

$ sudo port install mongodb


Install the following ports:

  • devel/libexecinfo
  • lang/clang38
  • lang/python

Optional Components if you want to use system libraries instead of the libraries included with MongoDB

  • archivers/snappy
  • lang/v8
  • devel/boost
  • devel/pcre

Add CC=clang38 CXX=clang++38 to the scons options, when building.


Install the following ports:

  • devel/libexecinfo
  • lang/gcc
  • lang/python

Special Build Notes