/homebrew-brew

The Official MongoDB Software Homebrew Tap

Primary LanguageRubyApache License 2.0Apache-2.0

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 locally, you can install individual software packages with:

$ brew install <formula>

For example:

  • Install the latest available production release of MongoDB Community Server (including all command line tools). This will currently install MongoDB 4.4.x:

    $ brew install mongodb-community
    
  • Install the latest 4.e.x production release of MongoDB Community Server and command line tools:

    $ brew install mongodb-community@4.4
    
  • Install the latest 4.2.x production release of MongoDB Community Server and command line tools:

    $ brew install mongodb-community@4.2
    
  • Install the latest 4.0.x production release of MongoDB Community Server and command line tools:

    $ brew install mongodb-community@4.0
    
  • Install the latest 3.6.x production release of MongoDB Community Server and command line tools:

    $ brew install mongodb-community@3.6
    
  • Only install the latest mongo shell for connecting to remote MongoDB instances:

    $ brew install mongodb-community-shell
    

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: /usr/local/etc/mongod.conf
  • a log directory path: /usr/local/var/log/mongodb
  • a data directory path: /usr/local/var/mongodb

Starting the mongodb-community Server

Run mongod as a service

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

Start mongod manually

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():

$ mongo admin --eval "db.shutdownServer()"

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.