2032. Installing MongoDB on Ubuntu and Mac

Introduce how to install MongoDB Community Edition on Ubuntu.

1. What is MongoDB?

MongoDB is a cross-platform, document oriented database that provides, high performance, high availability, and easy scalability. Key concepts of MongoDB: Database, Collection and Document.

1.1 Database

Database is a physical container for collections. Each database gets its own set of files on the file system. A single MongoDB server typically has multiple databases.

1.2 Collection

Collection is a group of MongoDB documents. It is the equivalent of an RDBMS table. A collection exists within a single database. Collections do not enforce a schema. Documents within a collection can have different fields. Typically, all documents in a collection are of similar or related purpose.

1.3 Document

A document is a set of key-value pairs. Documents have dynamic schema. Dynamic schema means that documents in the same collection do not need to have the same set of fields or structure, and common fields in a collection’s documents may hold different types of data.

2. Installing MongoDB on Ubuntu

1) Import the MongoDB public GPG Key.

$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 0C49F3730359A14518585931BC711F9BA15703C6

2) Create a list file for MongoDB.

$ echo "deb [ arch=amd64,arm64 ] http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list

3) Reload local package database.

$ sudo apt-get update

4) Install the MongoDB packages.

$ sudo apt-get install -y mongodb-org

5) Check MongoDB version.

$ mongo -version

6) Start MongoDB service and using it with mongo command.

$ sudo service mongod start
$ mongo

7) Generic Commands

$ sudo service mongod start       // Start MongoDB
$ sudo service mongod stop        // Stop MongoDB
$ sudo service mongod restart     // Restart MongoDB

3. Installing MongoDB on macOS with Homebrew

1) Update Homebrew’s package database.

$ brew update

2) Installing MongoDB.

$ brew install mongodb
Error: No available formula or cask with the name "mongodb".
==> Searching for a previously deleted formula (in the last month)...
Warning: homebrew/core is shallow clone. To get complete history run:
  git -C "$(brew --repo homebrew/core)" fetch --unshallow

Error: No previously deleted formula found.
==> Searching for similarly named formulae...
Error: No similarly named formulae found.
==> Searching taps...
==> Searching taps on GitHub...
Error: No formulae found in taps.

Formula mongodb has been removed from homebrew-core. Check pr-43770 from homebrew-core.

To our users: if you came here because mongodb stopped working for you, we have removed it from the Homebrew core formulas since it was migrated to a non open-source license.

Fortunately, the team of mongodb is maintaining a custom Homebrew tap. You can uninstall the old mongodb and reinstall the new one from the new tap.

brew services stop mongodb
brew uninstall mongodb

brew tap mongodb/brew
brew install mongodb-community
brew services start mongodb-community

3) Check MongoDB version.

$ mongo -version

4) Create the data directory.

$ mkdir -p /data/db

5) Start MongoDB service.

$ sudo mongod

6) Open another terminal, launch MongoDB Shell with mongo command.

$ mongo

4. Others

4.1 How to clear console in MongoDB?

  • Ubuntu: CTRL + L
  • macOS: Command + K

5. References