Navigation
This is an upcoming (i.e. in progress) version of the manual.

Install MongoDB Community Edition on macOS

Overview

The following tutorial uses brew to install MongoDB 4.2 Community Edition on macOS systems. To install a different version of MongoDB, please refer to that version’s documentation.

Platform Support

MongoDB only supports macOS versions 10.11 and later on Intel x86-64. See Supported Platforms for more information.

Install MongoDB Community Edition

Prerequisite

If you have previously tapped the official MongoDB formula repository, you can go directly to the Install MongoDB step.

If you have not previously tapped the official MongoDB formula repository, tap the official MongoDB formula repository to add to the formula list. From a terminal, issue the following:

brew tap mongodb/brew

Install MongoDB

From a terminal, issue the following:

brew install mongodb-community@4.2

In addition to the binaries, the install creates:

Run MongoDB

From a terminal, issue the following to run MongoDB (i.e. the mongod process) in the foreground.

mongod --config /usr/local/etc/mongod.conf

Alternatively, to run MongoDB as a macOS service, issue the following (the process uses the /usr/local/etc/mongod.conf file created during the install):

brew services start mongodb-community@4.2

Connect and Use MongoDB

To begin using MongoDB, connect a mongo shell to the running instance. From a new terminal, issue the following:
   mongo

For information on CRUD (Create,Read,Update,Delete) operations, see:

- :doc:`/tutorial/insert-documents`
- :doc:`/tutorial/query-documents`
- :doc:`/tutorial/update-documents`
- :doc:`/tutorial/remove-documents`

Additional Considerations

Localhost Binding

Starting with MongoDB 3.6, MongoDB binaries, mongod and mongos, bind to localhost by default.

When bound only to the localhost, these binaries can only accept connections from clients that are running on the same machine. Remote clients cannot connect to the binaries bound only to localhost. For more information, including how to override and bind to other ip addresses, see Localhost Binding Compatibility Changes.