How to Install MongoDB on Ubuntu in 2025: Step-by-Step Guide

Installing MongoDB on Ubuntu is a straightforward process. First, update your package manager by running sudo apt update and sudo apt upgrade. Then, import the MongoDB public GPG key with the command: wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -. Next, create a list file for MongoDB by running echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.

‍

org/apt/ubuntu focal/MongoDB-org/4.4 multiverse" | sudo tee /etc/apt/sources.list. d/MongoDB-org-4.4.list. Replace "focal" with your Ubuntu version if necessary. Update the package list again with the sudo apt update. Now, install MongoDB using sudo apt install -y MongoDB-org. Once installed, start the MongoDB service with sudo systemctl start mongod and enable it to start on boot using sudo systemctl enable mongod.

‍

You can check the status of the MongoDB service by running sudo systemctl status Mongod. Finally, access the MongoDB shell by typing Mongo. Your MongoDB installation is now complete and ready for use. Make sure to configure firewall settings if needed, especially if you plan to access MongoDB remotely.

‍

Introduction to MongoDB

MongoDB is a popular open-source NoSQL database designed for scalability, flexibility, and performance. Unlike traditional relational databases that use structured query language (SQL) and fixed schemas, MongoDB stores data in a JSON-like format called BSON (Binary JSON). This allows for a more dynamic data structure, enabling developers to handle unstructured data and complex data types more easily.

‍

One of the key features of MongoDB is its ability to scale horizontally, allowing it to handle large volumes of data across distributed systems. This makes it an ideal choice for modern applications that require high availability and rapid growth, such as web and mobile applications. MongoDB also supports a rich query language, indexing, and aggregation capabilities, providing powerful tools for data manipulation and retrieval.

‍

Additionally, MongoDB offers features like replication and sharding, ensuring data redundancy and improved performance. With its flexible data model, developers can iterate quickly and adapt to changing requirements without the constraints of predefined schemas. This adaptability, combined with its robust performance, has made MongoDB a favored choice among developers and organizations looking to leverage big data and real-time analytics.

‍

What is MongoDB used for?

‍

‍

MongoDB is a versatile NoSQL database used for various applications across different industries. Here are some common use cases:

‍

Web Applications

MongoDB is extensively used in web development due to its ability to manage diverse data types and its flexible schema. Developers can quickly iterate on their applications, adding new features without the constraints of a rigid structure.

‍

For instance, it can efficiently store user data, product catalogs, and session information, enabling responsive user experiences. Its powerful querying capabilities allow for complex searches, making it ideal for dynamic web applications that require real-time data updates.

‍

Big Data and Analytics

In the realm of big data, MongoDB excels at handling vast amounts of unstructured and semi-structured data. Its architecture supports horizontal scaling, which is crucial for processing large datasets across distributed systems.

‍

Businesses leverage MongoDB for real-time analytics, enabling them to derive actionable insights from data as it streams in. This capability is essential for industries that rely on immediate data-driven decision-making, such as finance and marketing.

‍

Content Management Systems (CMS)

MongoDB's flexibility makes it an excellent choice for content management systems. It allows developers to create dynamic, easily updatable content structures that can accommodate a variety of media types.

‍

With its schema-less design, developers can swiftly integrate new content formats or categories as needed. This adaptability helps organizations manage and deliver content efficiently, ensuring that users have access to the latest information and resources.

‍

Mobile Applications

In mobile app development, MongoDB serves as a robust backend database that manages user profiles, session data, and application content. Its ability to handle JSON-like documents allows for seamless synchronization of data across different devices.

‍

This ensures that users have a consistent experience, whether they are accessing the app on a smartphone or tablet. The scalability of MongoDB also supports growing user bases and increasing data volumes, which is critical for successful mobile applications.

‍

Internet of Things (IoT)

MongoDB is particularly well-suited for Internet of Things (IoT) applications due to its capability to manage and analyze data from numerous connected devices. It can handle diverse data formats and high write loads, which are common in IoT environments.

‍

The database's scalability ensures that it can accommodate the massive amounts of data generated by IoT sensors and devices. Organizations can leverage MongoDB for real-time monitoring, data collection, and analysis, leading to smarter, more efficient operations.

‍

Real-Time Analytics

Organizations use MongoDB for real-time data processing and analytics to facilitate immediate insights and decision-making. Its flexible data model allows for quick adjustments to data structures as new requirements arise.

‍

By employing MongoDB, businesses can analyze data as it flows in, enabling them to react swiftly to market changes or customer behaviors. This capability is invaluable for industries like retail and finance, where timely insights can drive competitive advantages.

‍

Gaming

In the gaming industry, MongoDB is utilized to manage player data, game states, and leaderboards efficiently. Its ability to handle complex data relationships and large volumes of information makes it ideal for dynamic gaming environments.

‍

MongoDB enables developers to create engaging and immersive gaming experiences by allowing for quick updates and real-time interactions. This flexibility ensures that player progress, in-game purchases, and social interactions are stored and retrieved seamlessly.

‍

E-Commerce

E-commerce platforms often rely on MongoDB to manage a variety of data, including product information, customer profiles, and transaction histories. Its flexible schema allows for easy adjustments as product offerings change or new features are added.

‍

MongoDB’s powerful querying capabilities enable fast searches and personalized experiences for users, enhancing customer engagement. Additionally, its ability to scale ensures that e-commerce sites can handle traffic spikes, especially during peak shopping seasons.

‍

Social Networking

Social media applications leverage MongoDB to manage diverse user-generated content, such as profiles, posts, and interactions. The database's flexibility allows developers to create complex data relationships, enabling features like friend connections, comments and likes.

‍

MongoDB’s scalability is crucial for accommodating large user bases and high volumes of interactions, ensuring a smooth user experience. By utilizing MongoDB, social networking platforms can evolve quickly, adapting to changing user needs and preferences.

‍

Healthcare Applications

In the healthcare sector, MongoDB is used to manage patient records, treatment histories, and research data. Its ability to handle varied data types and ensure data integrity is critical for compliance with regulations.

‍

The flexible schema allows healthcare providers to adapt to changing requirements, such as new treatment protocols or regulatory mandates. Additionally, MongoDB’s real-time data capabilities support timely access to patient information, improving decision-making and patient care outcomes.

‍

Prerequisites for Using MongoDB

Before you start using MongoDB, there are several prerequisites to ensure a smooth installation and effective utilization of the database. Here are the key requirements:

‍

System Requirements

To effectively run MongoDB, ensure your system meets the required specifications. For operating systems, MongoDB is compatible with Windows, macOS, and various Linux distributions.

‍

Check the official MongoDB documentation for the specific OS version required. A minimum of 2 GB of RAM is recommended, but for production environments, having more resources is advisable to handle larger datasets and traffic. To check your current RAM on Linux, you can use:

‍

free -h

Ensure your CPU can also handle the load, particularly for demanding applications.

‍

Package Manager

Having a package manager is crucial for installing and managing MongoDB on Linux systems. For Ubuntu, the Advanced Package Tool (apt) is commonly used, while CentOS utilizes the Yellowdog Updater, Modified (yum). Ensure you have administrative privileges to install software. To update your package manager, you can run:

‍

Sudo apt update

‍

After setting up your package manager, you can proceed to install MongoDB, which simplifies future updates and package management.

‍

Basic Command Line Knowledge

Familiarity with the command line interface is essential for interacting with MongoDB. You’ll often execute commands for installation, database management, and querying. Basic command-line skills involve navigating directories, managing files, and using text editors. For example, you can check your current directory with:

‍

pwd

‍

Or list files in a directory using:

‍

ls -la

‍

Being comfortable with these commands will enhance your efficiency in managing MongoDB.

‍

Networking Knowledge

Understanding basic networking concepts is important for setting up MongoDB, particularly if remote access or distributed architecture is involved. Familiarize yourself with concepts such as IP addresses, ports, and firewalls. For instance, MongoDB typically uses port 27017 for communication. You can check if the port is open with:

‍

sudo netstat -tuln | grep 27017

Having networking knowledge helps configure your MongoDB instance securely and effectively, especially in production environments.

‍

JavaScript and JSON Familiarity

Since MongoDB uses BSON (Binary JSON) for data storage, familiarity with JSON and JavaScript is beneficial. Understanding JSON syntax and structures will aid in creating and querying data in MongoDB. For example, a simple JSON document could look like this:

‍

{
  "name": "Alice",
  "age": 30,
  "city": "New York"
}

‍

This knowledge is crucial when writing queries and managing data, as it aligns with MongoDB's document-oriented approach.

‍

Development Environment

Setting up a suitable development environment is vital for working with MongoDB. Install programming languages such as Node.js, Python, or Java, depending on your application needs. You’ll also need to install relevant drivers or libraries for seamless integration. For instance, to install the MongoDB driver for Node.js, you can use:

‍

npm install MongoDB

‍

This setup ensures you have the tools necessary to develop applications that effectively utilize MongoDB.

‍

MongoDB Documentation

Familiarizing yourself with the official MongoDB documentation is crucial for effective database management. The documentation provides comprehensive guides, API references, and best practices. Regularly consulting the documentation can help troubleshoot issues and understand new features. You can access it at:

‍

https://docs.mongodb.com/

‍

Being well-versed in the documentation will empower you to maximize MongoDB's capabilities and stay updated with the latest developments.

‍

Backup Strategy

Establishing a backup strategy is essential before deploying MongoDB in production environments. MongoDB offers various tools for data backup, such as Mongodump and MongoDB. For instance, to create a backup, you can run:

‍

mongodump --db yourDatabaseName --out /backup/path

Understanding these processes ensures data integrity and availability, allowing for quick recovery in case of data loss or corruption.

‍

Security Awareness

Knowledge of security practices is critical when setting up MongoDB, especially for instances exposed to the internet. Familiarize yourself with authentication and authorization methods, such as enabling user accounts and setting up role-based access control. For example, to create a new user with read access, you can use:

‍

db.createUser({
  user: "username",
  pwd: "password",
  Roles: [{ role: "read," db: "yourDatabaseName" }]
});

‍

Implementing robust security measures helps protect sensitive data and maintains compliance with regulations.

‍

Installing MongoDB on Ubuntu 22.04

‍

‍

Installing MongoDB on Ubuntu 22.04 is a straightforward process. Here’s how to do it step by step:

‍

Update Package Database: Start by updating your package manager to ensure you have the latest information on available packages. Open the terminal and run:

sudo apt update

Install Required Packages: Install necessary packages to allow the use of repositories over HTTPS:

‍

sudo apt install -y gnupg wget

‍

Import the MongoDB GPG Key: Add the MongoDB GPG key for package verification:

wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-archive-keyring.gpg

Create the MongoDB Source List: Add the MongoDB repository to your system by creating a list file:

echo "deb [signed-by=/usr/share/keyrings/MongoDB-archive-keyring.gpg] https://repo.mongodb.org/apt/ubuntu jammy/MongoDB-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/MongoDB-org-6.0.list

Update Package Database Again: Refresh your package database to include the new MongoDB repository:
‍

sudo apt update

‍

Install MongoDB: Now, install MongoDB with the following command:

sudo apt install -y MongoDB-org

Start MongoDB: Once installed, start the MongoDB service:

sudo systemctl start mongod

Enable MongoDB to Start on Boot: To ensure MongoDB starts automatically when your system boots, run:

Sudo systemctl enable mongod

Check MongoDB Status: Verify that MongoDB is running correctly with:

‍

sudo systemctl status mongod

‍

Access MongoDB Shell: Finally, you can access the MongoDB shell by running:

mongo

Your MongoDB installation is now complete, and you can begin developing applications or managing data. Make sure to configure any necessary security settings based on your requirements!

‍

Starting and Enabling the MongoDB Service

After installing MongoDB on your Ubuntu system, it's essential to start the service and enable it to run automatically on boot. Here’s how to do that:

‍

Start the MongoDB Service: To initiate the MongoDB service, open your terminal and run:

‍

sudo systemctl start mongod

‍

• This command starts the MongoDB server, allowing you to interact with your databases.

‍

Enable MongoDB to Start on Boot: To ensure that MongoDB starts automatically each time your system boots, use the following command:
‍

sudo systemctl enable mongod

‍

• This command creates a symbolic link for the MongoDB service in the system's startup sequence.

‍

Check the Status of the MongoDB Service: After starting the service, you can check its status to confirm that it's running properly. Run:
‍

sudo systemctl status mongod

‍

• This command will display the current status, including whether the service is active and running.

• Stop or Restart the MongoDB Service (if needed): If you need to stop or restart the service, you can use:

‍

To stop:

sudo systemctl stop mongod

To restart:

sudo systemctl restart mongod

By following these steps, you can effectively manage the MongoDB service on your Ubuntu system, ensuring it is always available for your applications.

‍

Creating a Database and User in MongoDB

‍

‍

Creating a database and a user in MongoDB is a straightforward process. Here’s how to do it step by step:

‍

Access the MongoDB Shell: First, open your terminal and start the MongoDB shell by typing:
‍

mongo

‍

• This command connects you to the MongoDB server.

‍

Create a New Database: To create a new database, use the use command. Replace yourDatabaseName with your desired database name:
‍

use your database name

‍

• This command creates a new database if it doesn't already exist and switches to it.

‍

Create a New User: To create a user with specific roles, use the db.createUser() method. Here’s an example of creating a user with read-and-write access to the database:
‍

db.createUser({
  user: "your user name,"
  pwd: "yourPassword",
  roles: [{ role: "read-write," db: "yourDatabaseName" }]
});

‍

• Replace your username, your password, and your database name with your actual values. This command creates a new user with permission to read and write to the specified database.

‍

Verify the User Creation: To check if the user has been created successfully, you can run:
‍

db.getUsers()

‍

• This command lists all users in the current database.

‍

Exit the MongoDB Shell: Once you’ve finished, exit the shell by typing:

exit

By following these steps, you can easily create a new database and user in MongoDB, allowing for secure data management and access control. Make sure to implement strong passwords and appropriate roles based on your application's requirements.

‍

Securing MongoDB on Ubuntu

Securing MongoDB is crucial to protect your data from unauthorized access and potential vulnerabilities. Here are key steps to enhance the security of your MongoDB installation on Ubuntu:

‍

Enable Authentication: By default, MongoDB does not require authentication. To enable it, edit the MongoDB configuration file:
‍

Sudo nano /etc/mongod.conf

‍

Find the security section and add the following:

Security:
  authorization: "enabled"

‍

Save the changes and restart MongoDB:

‍

sudo systemctl restart mongod

‍

Create Administrative Users: Always create an admin user before enabling authentication. Connect to the MongoDB shell and run:

use admin
db.createUser({
  user: "admin,"
  pwd: "strongPassword",
  roles: [{ role: "userAdminAnyDatabase," db: "admin" }]
});

Use Network Access Controls: By default, MongoDB binds to all interfaces. Restrict it to localhost or a specific IP by editing the mood.conf file:
‍

bind: 127.0.0.1  # or your server's IP

‍

• This change ensures that only specified IPs can connect to the MongoDB server.

‍

Enable SSL/TLS: For secure data transmission, enable SSL/TLS. Obtain an SSL certificate and configure it in the Mongod.conf file:
‍

Net:
  SSL:
    mode: required
    PEMKeyFile: /path/to/your/ssl.pem

‍

• Restart MongoDB after making these changes.

‍

Regularly Update MongoDB: Keep your MongoDB installation up to date to benefit from the latest security patches and features. Use:
‍

sudo apt update
sudo apt upgrade MongoDB-org

‍

Backup Data: Regularly back up your data using Mongodump to ensure you can restore it in case of a breach or data loss:
‍

mongodump --db yourDatabaseName --out /path/to/backup

‍

• Monitor Logs: Regularly check MongoDB logs for any unauthorized access attempts or unusual activity. The log file is usually located at /var/log/mongodb/mongod.log.

‍

By implementing these security measures, you can significantly enhance the security of your MongoDB installation on Ubuntu, protecting your data and maintaining a secure environment.

‍

Configuring MongoDB for Remote Access

To allow remote access to your MongoDB server, you need to make several configuration changes. Follow these steps:

‍

Edit the Configuration File: Open the MongoDB configuration file:

‍

Sudo nano /etc/mongod.conf

‍

Modify Bind IP Address: By default, MongoDB binds to localhost (127.0.0.1). To allow remote access, change the bindIp setting to the server's IP address or 0.0.0.0 to allow access from any IP (not recommended for production). Update the net section:
‍

Net:
  bind: 0.0.0.0  # or specify your server's IP
  port: 27017

‍

Enable Authentication: Ensure authentication is enabled for security. In the same configuration file, confirm the security section includes:
‍

Security:
  authorization: "enabled"

‍

Restart MongoDB: Save your changes and restart the MongoDB service:
‍

sudo systemctl restart mongod

‍

Configure Firewall: If you have a firewall enabled, allow traffic on MongoDB’s default port (27017). For example, with UFW, run:
‍

Sudo ufw allow 27017

‍

Test Remote Connection: From a remote machine, use the MongoDB shell to connect:

‍

mongo --host yourServerIP --port 27017 -u yourUsername -p yourPassword --authenticationDatabase admin

‍

Working with MongoDB Database

Once MongoDB is configured for remote access, you can start working with databases. Here’s how to perform basic operations:

‍

Access the MongoDB Shell: Connect to your MongoDB instance using:
‍

mongo

‍

Create a Database: To create and switch to a new database, use:

use your database name

Create Collections: Collections in MongoDB are similar to tables in relational databases. To create a collection, use:
‍

db.createCollection("yourCollectionName")

‍

Insert Documents: You can insert documents (records) into your collection:
‍

db.your collection name.insert one({
  name: "John Doe,"
  age: 30,
  city: "New York"
})

‍

Query Documents: Retrieve documents using queries:
‍

db.yourCollectionName.find({ age: { $gt: 25 } })

‍

Update Documents: Update existing documents with the updated or update any method:
‍

db.your collection name.update(
  { name: "John Doe" },
  { $set: { age: 31 } }
)

‍

Delete Documents: Remove documents from your collection using:
‍

db.yourCollectionName.deleteOne({ name: "John Doe" })

‍

List Databases and Collections: To view all databases and collections, use:

Show DBS  // To list databases
Show collections  // To list collections in the current database

By following these steps, you can effectively configure MongoDB for remote access and perform essential operations on your databases. This setup allows you to manage and interact with your MongoDB databases securely and efficiently.

‍

Conclusion

Installing MongoDB on Ubuntu is a straightforward process that can be completed in just a few steps. By following the installation guide, you can set up a powerful NoSQL database that supports flexible data models and high scalability. After installation, configuring MongoDB for remote access allows you to manage your databases from different locations, making it suitable for various applications.

‍

It's important to implement security measures, such as enabling authentication and restricting access through IP settings, to protect your data. Regular updates and backups will help maintain the integrity and availability of your database.