Similar to the previous recipe, Installing and starting MongoDB on Linux, we will see how to set up MongoDB on a macOS operating system.
MongoDB supports macOS 10.7 (Lion) or higher, so ensure that your operating system is upgraded. Download the binary files the latest stable binary tarball from https://www.mongodb.com/download-center.
- In this recipe, we will be installing MongoDB in the user's home directory. Create a directory
~/data/
and extract the TAR file in this directory:
tar xvf mongodb-osx-x86_64-3.4.4.tgz
All of MongoDB's core binaries are available in the ~/data/mongodb-osx-x86_64-3.4.4/bin
directory.
- Create a symbolic link to the versioned file directory for simpler naming conventions and also allowing us to use a generic directory name (for example, in scripts):
cd ~/data/ ln -s mongodb-osx-x86_64-3.4.4 mongodb
- Create a directory for the database:
mkdir ~/data/db
- Start the MongoDB server:
~/data/mongodb/bin/mongod --dbpath ~/data/db
- You should see output like this:
2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] MongoDB starting : pid=960 port=27017 dbpath=/Users/cyrus.dasadia/data/db 64-bit host=foo 2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] db version v3.4.4 2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] git version: 888390515874a9debd1b6c5d36559ca86b44babd 2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] allocator: system 2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] modules: none 2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] build environment: 2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] distarch: x86_64 2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] target_arch: x86_64 2017-05-21T15:21:20.662+0530 I CONTROL [initandlisten] options: { storage: { dbPath: "/Users/cyrus.dasadia/data/db" } } <<--- snip -- >> 2017-05-21T15:21:21.492+0530 I NETWORK [thread1] waiting for connections on port 27017
- You can press Ctrl + C to stop the server.
- Additionally, for convenience, we can edit the system's
PATH
variable to include the MongoDB binaries directory. This allows us invoke the MongoDB binaries without having to type the entire path. For example, to execute the mongo client, instead of having to type~/mongodb/bin/mongo
every time we can simply typemongo
. This can be done by appending your~/.bashrc
or~/.zshrc
files forbash
andzsh
respectively, with the following lines:
PATH=~/data/mongodb/bin:${PATH} export PATH
Similar to our first recipe, we downloaded a precompiled binary package and started the MongoDB server using the most basic command line parameter --dbpath
such that it uses a customized directory ~/data/db
for storing databases. As you might have noticed, MongoDB server by default, starts listening on TCP 27017
on all interfaces. We also saw how to add the MongoDB binary directory's path to our system's PATH
variable for a more convenient way to access the MongoDB binaries.