You can support us by downloading this article as PDF from the Link below. Download the guide as PDF

In this guide, we will cover the steps to install MongoDB 4 on RHEL 8 / CentOS 8. MongoDB is an open source NoSQL database system written in C++ designed to ensure scalability, high performance, and availability.

MongoDB common use case is storage and management of Big Data-sized collections of literal documents like text documents, email messages, XML documents, and many others.

Install MongoDB 4 on RHEL 8 / CentOS 8

MongoDB 4 is available on MongoDB yum repository. Add the repository to your RHEL 8 server by running below commands:

sudo tee /etc/yum.repos.d/mongodb-org-4.repo<<EOF
name=MongoDB Repository

You need to run the commands above as root user. Once the repo has been added, install mongodb-org package.

MongoDB Repository                                                                                                 2.3 kB/s | 3.4 kB     00:01    
Dependencies resolved.
 Package                           Arch                  Version                                                Repository                    Size
 mongodb-org                       x86_64                4.2.1-1.el8                                            mongodb-org-4                 10 k
Installing dependencies:
 python2                           x86_64                2.7.15-24.module_el8.0.0+193+7850e68f                  AppStream                    107 k
 python2-libs                      x86_64                2.7.15-24.module_el8.0.0+193+7850e68f                  AppStream                    6.0 M
 python2-pip                       noarch                9.0.3-13.module_el8.0.0+32+017b2cba                    AppStream                    2.0 M
 python2-setuptools                noarch                39.0.1-11.module_el8.0.0+32+017b2cba                   AppStream                    643 k
 mongodb-org-mongos                x86_64                4.2.1-1.el8                                            mongodb-org-4                 14 M
 mongodb-org-server                x86_64                4.2.1-1.el8                                            mongodb-org-4                 25 M
 mongodb-org-shell                 x86_64                4.2.1-1.el8                                            mongodb-org-4                 17 M
 mongodb-org-tools                 x86_64                4.2.1-1.el8                                            mongodb-org-4                 47 M
Enabling module streams:
 python27                                                2.7                                                                                      

Transaction Summary
Install  9 Packages

Total download size: 111 M
Installed size: 295 M
Is this ok [y/N]: y

The installation of the above package will install the following dependency packages:

mongodb-org-server – This provides MongoDB daemon mongod
mongodb-org-mongos – This is a MongoDB Shard daemon
mongodb-org-shell – This provides a shell to MongoDB
mongodb-org-tools – MongoDB tools used for export, dump, import e.t.c

You can verify installation of above packages, e.g.

$ rpm -qi mongodb-org-server 
Name        : mongodb-org-server
Version     : 4.2.1
Release     : 1.el8
Architecture: x86_64
Install Date: Sat 26 Oct 2019 12:26:16 AM EAT
Group       : Applications/Databases
Size        : 71824540
License     : AGPL 3.0
Signature   : RSA/SHA1, Fri 18 Oct 2019 10:19:57 AM EAT, Key ID 4b7c549a058f8b6b
Source RPM  : mongodb-org-4.2.1-1.el8.src.rpm
Build Date  : Wed 16 Oct 2019 05:23:12 AM EAT
Build Host  : ip-10-122-67-134.ec2.internal
Relocations : /usr 
URL         :
Summary     : MongoDB database server

Configure MongoDB on RHEL 8 / CentOS 8

When the packages are installed, you can start customizing and configuring MongoDB before starting the service.

Label MongoDB port

If you have SELinux in enforcing mode, you may need to label port 27017

sudo semanage port -a -t mongod_port_t -p tcp 27017

Allow mongo port on the firewall

If you have firewalld running on your server and would like MongoDB service to be accessible over the network, open it on the firewall:

sudo firewall-cmd --add-port=27017/tcp --permanent
sudo firewall-cmd --reload

You can also limit access based on source address

sudo firewall-cmd --permanent --add-rich-rule "rule family="ipv4" \
source address="" port protocol="tcp" port="27017" accept"

Use secondary disk for MongoDB data – Optional

You can always use a dedicated disk / virtual disk to store MongoDB data. This can be configured like below

Step 1: Partition secondary disk for MongoDB data:

# lsblk  | grep vdb
vdb 252:16 0 50G 0 disk

Step 2: Create a GPT partition table for the secondary disk, it can be more than onde disk

sudo parted -s -a optimal -- /dev/vdb mklabel gpt
sudo parted -s -a optimal -- /dev/vdb mkpart primary 0% 100%
sudo parted -s -- /dev/vdb align-check optimal 1

Step 3: Create LVM volume, this will make it easy to extend the partition

sudo pvcreate  /dev/vdb1
sudo vgcreate vg11 /dev/vdb1
sudo lvcreate -n data -l 100%FREE vg11

Step 4: Create XFS filesystem on the Logical Volume created

sudo mkfs.xfs /dev/mapper/vg11-data

Step 5: Create a mount point and mount the partition

echo "/dev/mapper/vg11-data /data xfs defaults 0 0" | sudo tee -a /etc/fstab
sudo mkdir /data
sudo mount -a

Step 6: Create a folder for MongoDB data

sudo mkdir /data/mongo
sudo chown -R mongod:mongod /data/mongo
sudo chmod -R 775 /data/mongo

Step 7: Confirm that the partition mount was successful:

df -hT | grep  /data/mongo

Step 8: Change MongoDB data store location on /etc/mongod.conf

dbPath: /data/mongo 
  enabled: true

Start MongoDB Service

When all is set, start and set mongod service to start on boot.

sudo systemctl enable --now mongod

If the service was started successfully, it should show running status.

$ systemctl status mongod.service 
● mongod.service - MongoDB Database Server
Loaded: loaded (/usr/lib/systemd/system/mongod.service; enabled; vendor preset: disabled)
Active: active (running) since Sat 2019-01-05 12:12:28 EAT; 4s ago
Process: 2163 ExecStart=/usr/bin/mongod $OPTIONS (code=exited, status=0/SUCCESS)
Process: 2161 ExecStartPre=/usr/bin/chmod 0755 /var/run/mongodb (code=exited, status=0/SUCCESS)
Process: 2160 ExecStartPre=/usr/bin/chown mongod:mongod /var/run/mongodb (code=exited, status=0/SUCCESS)
Process: 2158 ExecStartPre=/usr/bin/mkdir -p /var/run/mongodb (code=exited, status=0/SUCCESS)
Main PID: 2166 (mongod)
Memory: 70.1M
CGroup: /system.slice/mongod.service
└─2166 /usr/bin/mongod -f /etc/mongod.conf
Jan 05 12:12:27 localhost.localdomain systemd[1]: Starting MongoDB Database Server…
Jan 05 12:12:27 localhost.localdomain mongod[2163]: about to fork child process, waiting until server is ready for connections.
Jan 05 12:12:27 localhost.localdomain mongod[2163]: forked process: 2166
Jan 05 12:12:28 localhost.localdomain mongod[2163]: child process started successfully, parent exiting
Jan 05 12:12:28 localhost.localdomain systemd[1]: Started MongoDB Database Server.

For Authentication, check our guide on How to configure MongoDB 4 authentication.

More articles:

How To Join CentOS 8 / RHEL 8 System to Active Directory (AD) domain

How To Manage CentOS 8 With Cockpit Web Admin Console

How To Install CentOS 8 Step by Step with Screenshots

How To Install Chef Workstation on CentOS 8 / RHEL 8

You can support us by downloading this article as PDF from the Link below. Download the guide as PDF