Install MongoDB Community Edition on OS X¶
Use this tutorial to install MongoDB Community Edition on OS X systems.
Starting in version 3.0, MongoDB only supports OS X versions 10.7 (Lion) and later on Intel x86-64.
Install MongoDB Community Edition¶
To install a version of MongoDB prior to 3.2, please refer to that version’s documentation. For example, see version 3.0.
Install MongoDB Community Edition Manually¶
Download the binary files for the desired release of MongoDB.¶
Download the binaries from
For example, to download the latest release through the shell, issue the following:
curl -O https://fastdl.mongodb.org/osx/mongodb-osx-x86_64-3.4.2.tgz
Extract the files from the downloaded archive.¶
For example, from a system shell, you can extract through the
tar -zxvf mongodb-osx-x86_64-3.4.2.tgz
Copy the extracted archive to the target directory.¶
Copy the extracted folder to the location from which MongoDB will run.
mkdir -p mongodb cp -R -n mongodb-osx-x86_64-3.4.2/ mongodb
Ensure the location of the binaries is in the
The MongoDB binaries are in the
bin/ directory of the archive. To
ensure that the binaries are in your
PATH, you can modify your
For example, you can add the following line to your shell’s
rc file (e.g.
<mongodb-install-directory> with the path to the extracted
Install MongoDB Community Edition with Homebrew¶
Homebrew installs binary packages based on published
“formulae.” This section describes how to update
brew to the latest
packages and install MongoDB Community Edition. Homebrew requires some initial
setup and configuration, which is beyond the scope of this document.
Update Homebrew’s package database.¶
In a system shell, issue the following command:
You can install MongoDB via
brew with several different options. Use
one of the following operations:
Install the MongoDB Binaries¶
To install the MongoDB binaries, issue the following command in a system shell:
brew install mongodb
Install the MongoDB Binaries with TLS/SSL Support¶
To install the MongoDB binaries that have TLS/SSL support, issue the following from a system shell:
brew install mongodb --with-openssl
Install the Latest Development Release of MongoDB¶
To install the latest development release for use in testing and development, issue the following command in a system shell:
brew install mongodb --devel
Create the data directory.¶
Before you start MongoDB for the first time, create the directory to
mongod process will write data. By default, the
mongod process uses the
/data/db directory. If you create
a directory other than this one, you must specify that directory in the
dbpath option when starting the
later in this procedure.
The following example command creates the default
mkdir -p /data/db
Run without specifying paths¶
If your system
PATH variable includes the location of the
mongod binary and if you use the default data directory
/data/db), simply enter
mongod at the system prompt:
<path to binary>/mongod
Specify the path of the data directory¶
If you do not use the default data directory (i.e.,
specify the path to the data directory using the
mongod --dbpath <path to data directory>
Begin using MongoDB.¶
Before deploying MongoDB in a production environment, consider the Production Notes document.
Later, to stop MongoDB, press
Control+C in the terminal where the
mongod instance is running.