- Install MongoDB >
- Install MongoDB Community Edition >
- Install MongoDB Community Edition on macOS >
- Install using
.tgz
Tarball on macOS
Install using .tgz
Tarball on macOS¶
Overview¶
The following tutorial downloads the .tgz
file directly to install
MongoDB Community Edition on macOS. To install using brew
, see
Install MongoDB Community Edition on macOS instead.
Note
To install a different version of MongoDB, please refer to that version’s documentation. For example, see version 3.2.
Platform Support¶
Changed in version 3.4.11: MongoDB now requires macOS 10.8 or later.
MongoDB requires macOS version 10.8 (Mountain Lion) or later running on an x86_64 processor.
Install MongoDB Community Edition¶
Download the MongoDB .tgz file.¶
Download the tarball for macOS from the MongoDB Download Center.
Extract the files from the downloaded archive.¶
For example, from a system shell, you can extract through the tar
command:
If your web browser automatically unzips the file as part of the
download, the file would end in .tar
instead.
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, you must create the
directory to which the mongod
process will write data.
For example, to create the /usr/local/var/mongodb
directory:
Important
Starting with macOS 10.15 Catalina, Apple restricts access to the
MongoDB default data directory of /data/db
. On macOS 10.15
Catalina, you must use a different data directory, such as
/usr/local/var/mongodb
.
Create the log directory.¶
You must also create the directory in which the mongod
process
will write its log file:
For example, to create the /usr/local/var/log/mongodb
directory:
Set permissions for the data and log directories.¶
Ensure that the user account running mongod
has read
and write permissions for these two directories. If you are running
mongod
as your own user account, and you just created
the two directories above, they should already accessible to your
user. Otherwise, you can use chown
to set ownership,
substituting the appropriate user:
Run MongoDB.¶
To run MongoDB, run the mongod
process at the system
prompt, providing the two parameters dbpath
and logpath
from above, and the fork
parameter to run mongod
in the background. Alternatively, you may choose to store the values
for dbpath
, logpath
, fork
, and many other parameters in a
configuration file.
Run mongod
with command-line parameters¶
Run the mongod
process at the system prompt,
providing the three necessary parameters directly on the
command-line:
Run mongod
with a configuration file¶
Run the mongod
process at the system prompt,
providing the path to a
configuration file
with the config
parameter:
Note
If you receive an error message indicating that mongod
could
not be opened, go to System Preferences > Security and Privacy.
Under the General tab, click the “Allow Anyway” button to the
right of the message about mongod.
Verify that MongoDB has started successfully.¶
Verify that MongoDB has started successfully:
If you do not see a mongod
process running, check the logfile for
any error messages.
Begin using MongoDB.¶
Start a mongo
shell on the same host machine as the
mongod
. You can run the mongo
shell
without any command-line options to connect to a
mongod
that is running on your localhost with the
default port of 27017:
Note
If you needed to explicitly approve the mongod
application in
System Preferences above, you must also do so for mongo
.
For more information on connecting using the mongo
shell, such as to connect to a mongod
instance running
on a different host and/or port, see The mongo Shell.
To help you start using MongoDB, MongoDB provides Getting Started Guides in various driver editions. See Getting Started for the available editions.