How to setup MongoDB on MacOS

 by Robin Wieruch
 - Edit this Post
mongodb macos, mongodb setup, mongodb os setup

This is a tutorial for setting up MongoDB on MacOS. You might be wondering why there's a need for another setup guide for MongoDB in the first place, since there are a few across the web. I found many tutorials and guides on how to set it up, but found most of them to be unclear and outdated, based on old MongoDB versions. The checklist is not comprehensive, though, as it is used for several tutorials on my website, I keep it updated with the recent versions of MongoDB. If you spot any flaws in this guide, a comment below would be very helpful to keep it up to date for other developers.

If you want to run MongoDB on Windows instead, you will find guidance over here: How to setup MongoDB on Windows.

MongoDB Installation on MacOS

I recommend Homebrew for installing and managing applications on MacOS. It is installed using the following command in the MacOS terminal. Open up the terminal and paste the command:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

The terminal runs through a series of installation operations, and will probably create folders in your local machine to accommodate Homebrews storage requirements. You can find more detailed instructions here. After it's installed, update the Homebrew dependencies and install MongoDB on the command line:

brew update
brew install mongodb

It will take a few seconds. Once it's done, create a directory so MongoDB can store its data.

sudo mkdir -p /data/db

Now to make sure this data directory have the right permissions, you'll run this command:

sudo chown -R `id -un` /data/db

Now our data directory is ready with right permissions. Next run mongo daemon. Which is a service which runs in the background and listens for connections on a given port. Run this command:

mongod

Now mongo daemon will be running in the background and can be used by your applications. Next, check your MongoDB version:

mongo --version
MongoDB shell version: 4.0.5

The command line results will show the version you have installed on your local machine. I recommend using the latest version of libraries and software whenever possible to avoid compatibility issues with client-side applications.

Keep reading 

This is a tutorial for setting up MongoDB on Windows. You might be wondering why there's a need for another setup guide for MongoDB in the first place, since there are a few across the web. I found…

This is a tutorial for setting up PostgreSQL 11 on MacOS. You might be wondering why there's a need for another setup guide for Postgres in the first place, since there are a few across the web. I…

The Road to React

Learn React by building real world applications. No setup configuration. No tooling. Plain React in 200+ pages of learning material. Learn React like 50.000+ readers.

Get it on Amazon.