- Install MongoDB >
- Install MongoDB on OS X
Install MongoDB on OS X¶
On this page
Overview¶
Use this tutorial to install MongoDB on OS X systems.
Platform Support
Starting in version 2.4, MongoDB only supports OS X versions 10.6 (Snow Leopard) on Intel x86-64 and later.
MongoDB is available through the popular OS X package manager Homebrew or through the MongoDB Download site.
Install MongoDB¶
Download the binary files for the desired release of MongoDB.¶
The downloads-distro.mongodb.org
host has been decommissioned. To
get the binaries for MongoDB 2.6 (which has reached end of life on
October 2016):
- For the Community Edition, you can download from https://www.mongodb.org/dl/linux/x86_64.
- For the Enterprise Edition, you can download from https://www.mongodb.com/download-center/enterprise/releases/archive.
For example, to download the latest release through the shell, issue the following:
Extract the files from the downloaded archive.¶
For example, from a system shell, you can extract through the tar
command:
Copy the extracted archive to the target directory.¶
Copy the extracted folder to the location from which MongoDB will run.
Ensure the location of the binaries is in the PATH
variable.¶
The MongoDB binaries are in the bin/
directory of the archive. To
ensure that the binaries are in your PATH
, you can modify your
PATH
.
For example, you can add the following line to your shell’s
rc
file (e.g. ~/.bashrc
):
Replace <mongodb-install-directory>
with the path to the extracted
MongoDB archive.
Run MongoDB¶
Create the data directory.¶
Before you start MongoDB for the first time, create the directory to
which the 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 mongod
process
later in this procedure.
The following example command creates the default /data/db
directory:
Run MongoDB.¶
To run MongoDB, run the mongod
process at the system prompt.
If necessary, specify the path of the mongod
or the data
directory. See the following examples.
Run without specifying paths¶
If your system PATH
variable includes the location of the
mongod
binary and if you use the default data directory
(i.e., /data/db
), simply enter mongod
at the system prompt:
Begin using MongoDB.¶
To begin using MongoDB, see Getting Started with MongoDB. Also consider the Production Notes document before deploying MongoDB in a production environment.
Later, to stop MongoDB, press Control+C
in the terminal where the
mongod
instance is running.