MongoDB - Installation process

Yaazhvendhan MS — Mon, 06 Oct 2025 10:26:21 +0000

If you’ve ever wanted a visual way to explore your MongoDB databases without writing endless queries, MongoDB Compass is your best friend. It’s the official GUI for MongoDB and works across Linux, macOS, and Windows. This guide will walk you through installing it step by step.

1. Installing MongoDB Compass on Linux

MongoDB Compass comes in two package formats for Linux:RPM for Fedora, CentOS, and RHEL, and DEB for Ubuntu and Debian.

RPM-based distributions (Fedora, CentOS, RHEL)
Download the RPM package:
wget https://downloads.mongodb.com/compass/mongodb-compass-1.46.10.x86_64.rpm

Install the package using yum:
sudo yum install mongodb-compass-1.46.10.x86_64.rpm

Launch MongoDB Compass:
mongodb-compass

After launching, you can sign into your MongoDB Atlas account and start exploring your databases.

DEB-based distributions (Ubuntu, Debian)
Download the DEB package:
wget https://downloads.mongodb.com/compass/mongodb-compass_1.46.10_amd64.deb

Install using apt:
sudo apt install ./mongodb-compass_1.46.10_amd64.deb

Troubleshooting dependencies:If the installation fails due to missing dependencies, fix it with:

sudo dpkg -i mongodb-compass_1.46.10_amd64.deb
sudo apt-get install -f

Launch Compass:
mongodb-compass

2. Installing MongoDB Compass on macOS

Requirements

macOS 10.12 or later (64-bit)

MongoDB 7.0 or later

Supported architectures: x64 and ARM64 (M1 users, download the ARM64 version)

Steps
Download the .dmg file from the MongoDB Compass downloads page link .

Open the .dmg file and drag MongoDB Compass to your Applications folder.

Eject the disk image.

Open Compass from Applications. If you see a security warning about opening an application from the internet, click Open to continue.

macOS may ask for your password or request permission for Compass to run—this is normal.

3. Installing MongoDB Compass on Windows

Requirements

Windows 10 or later (64-bit)

MongoDB 7.0 or later

Microsoft .NET Framework 4.5 or later

Steps

Download the installer from the MongoDB Compass downloads page link . You can choose between .exe, .msi, or .zip.

Run the installer. If installing on a system like Azure Virtual Desktop, run it as Administrator.

Follow the prompts and select your preferred installation location.

After installation, launch Compass and configure privacy settings and update preferences.

@santhoshnc

DEV Community: Yaazhvendhan MS

MongoDB - Installation process