The MongoDB Homebrew Tap
This is a custom Homebrew tap for official MongoDB software.
Setup
You can add the custom tap in a MacOS terminal session using:
brew tap mongodb/brew
Installing Formulae
Once the tap has been added, use the instructions below to install the software packages you need. You can choose to install either the latest version of the MongoDB Server (recommended), or a specific version if desired.
Installing the Latest mongodb-community Server, Shell, and the Database Tools Together
-
Install the latest available production release of the MongoDB Community Server. This includes the MongoDB Server processes
mongod
andmongos
, the MongoDB Database Tools, and theinstall_compass
script to separately install MongoDB Compass. Currently, this will install MongoDB Server 6.0.x.brew install mongodb-community
Installing only the Shell or the Database Tools
-
Install only the latest
mongosh
shell for connecting to remote MongoDB instances. If you installed the MongoDB Server in the step above, the shell was included in that installation. Use this command only if you need to install themongosh
shell separately.brew install mongosh
-
Install only the latest MongoDB Database Tools, a suite of command-line tools (
mongoimport
,mongoexport
,mongodump
, etc) for working with a MongoDB Server instance. If you installed the MongoDB Server in the step above, the Database Tools were included in that installation. Use this command only if you need to install the Database Tools separately.brew install mongodb-database-tools
Installing a Specific Version of the mongodb-community Server
Alternatively, you can install a specific version of the MongoDB Server if desired.
-
Install the latest 6.0.x production release of MongoDB Community Server:
brew install [email protected]
-
Install the latest 5.0.x production release of MongoDB Community Server:
brew install [email protected]
-
Install the latest 4.4.x production release of MongoDB Community Server:
brew install [email protected]
Default Paths for the mongodb-community Formula
In addition to installing the MongoDB server and tool binaries, the mongodb-community
formula creates:
- a configuration file:
$(brew --prefix)/etc/mongod.conf
- a log directory path:
$(brew --prefix)/var/log/mongodb
- a data directory path:
$(brew --prefix)/var/mongodb
The default value for brew --prefix
depends on your CPU architecture:
- Intel:
/usr/local
- M1:
/opt/homebrew
Starting the mongodb-community Server
mongod
as a service
Run To have launchd
start mongod
immediately and also restart at login, use:
brew services start mongodb-community
If you manage mongod
as a service it will use the default paths listed above. To stop the server instance use:
brew services stop mongodb-community
mongod
manually
Start If you don't want or need a background MongoDB service you can run:
mongod --config /usr/local/etc/mongod.conf
Note: if you do not include the --config
option with a path to a configuration file, the MongoDB server does not have a default configuration file or log directory path and will use a data directory path of /data/db
.
To shutdown mongod
started manually, use the admin
database and run db.shutdownServer()
:
- Shutdown for MongoDB Community Server 6.x and up:
mongosh admin --eval "db.shutdownServer()"
- Shutdown for MongoDB Community Server 5.0 and below:
mongo admin --eval "db.shutdownServer()"
Uninstalling the mongodb-community Server
If you need to uninstall the MongoDB Server, use:
brew uninstall mongodb-community
Note that this does not uninstall the bundled Database Tools. To uninstall the Database Tools, additionally run the folowing:
brew uninstall mongodb-database-tools
The Documentation
For more information, please reference the following documentation:
Additional Information and Problem Reporting
This tap was created using the Homebrew documentation on How to Create and Maintain a tap.
You can find additional information in the Homebrew project README.
If you're having issues with MongoDB please check out our community support resources.
If you've found a bug please open a JIRA ticket in the SERVER project.