Admin: New server guide

2026-04-14T20:01:25Z

New server guide

New page

# Installing MongoDB

This guide details how to install MongoDB, a popular NoSQL database, on a Linux server. A successful MongoDB setup is crucial for many modern web applications that require flexible data storage. We will cover the installation process, basic configuration, and essential commands for managing your database.

## Prerequisites

Before you begin, ensure you have the following:

* A Linux server. For optimal performance and control, consider a [[Dedicated Servers|dedicated server]] from PowerVPS, offering full root access.
* SSH access to your server.
* A user with `sudo` privileges.
* Basic familiarity with the Linux command line.

## Understanding NoSQL Databases

NoSQL, which stands for "Not Only SQL," refers to a category of databases that do not use the traditional relational (table-based) structure of SQL databases. Instead, they offer flexible data models, such as document, key-value, or graph. MongoDB is a *document database*, meaning it stores data in JSON-like documents, allowing for dynamic schemas. This flexibility is beneficial when your data structure might change frequently or when dealing with complex, nested data.

## Installing MongoDB

We will install MongoDB from the official repositories to ensure you get the latest stable version.

### 1. Update Package Lists

First, refresh your server's package index to ensure you download the most recent versions of software.

```bash
sudo apt update
```

### 2. Install MongoDB

Now, install the MongoDB server and client packages.

```bash
sudo apt install mongodb
```

This command installs the core MongoDB server (`mongodb-server`) and the command-line client (`mongodb-client`).

### 3. Verify Installation

After the installation completes, the MongoDB service should start automatically. You can check its status with the following command:

```bash
sudo systemctl status mongodb
```

You should see output indicating that the service is `active (running)`. Press `q` to exit the status view.

## Basic MongoDB Configuration

MongoDB's main configuration file is located at `/etc/mongod.conf`. For most basic setups, the default configuration is sufficient. However, you might want to adjust settings like network binding or log file locations.

### Network Binding

By default, MongoDB binds to `127.0.0.1` (localhost), meaning it's only accessible from the server itself. If you need to connect to your MongoDB instance from other machines, you'll need to change this.

1. Open the configuration file using a text editor like `nano`:

```bash
sudo nano /etc/mongod.conf
```

2. Find the `net:` section. It will look something like this:

```yaml
net:
port: 27017
bindIp: 127.0.0.1
```

3. To allow connections from any IP address, change `bindIp` to `0.0.0.0`. **Warning:** Binding to `0.0.0.0` makes your MongoDB instance accessible from any network. Ensure you have a firewall configured to restrict access to trusted IP addresses. For more secure access, you can specify a comma-separated list of IP addresses or ranges.

```yaml
net:
port: 27017
bindIp: 0.0.0.0
```

4. Save the file and exit `nano` (Ctrl+X, then Y, then Enter).

5. Restart the MongoDB service for the changes to take effect:

```bash
sudo systemctl restart mongodb
```

## Connecting to MongoDB

You can connect to your MongoDB instance using the `mongo` shell.

### Connecting Locally

If MongoDB is running on the same server and bound to localhost, use this command:

```bash
mongo
```

This will open the MongoDB shell, indicated by the `>` prompt.

### Connecting Remotely

If you've configured network binding to allow remote connections and have set up your firewall, you can connect from another machine using:

```bash
mongo --host your_server_ip --port 27017
```

Replace `your_server_ip` with the actual IP address of your MongoDB server.

## Basic MongoDB Commands

Once inside the `mongo` shell, you can perform various operations.

### Show Databases

To list all available databases:

```javascript
show dbs
```

### Use a Database

To switch to a specific database (or create it if it doesn't exist):

```javascript
use myDatabase
```

### Show Collections

After selecting a database, you can list its collections (similar to tables in SQL):

```javascript
show collections
```

### Insert a Document

To add a new record (document) to a collection. Let's create a `users` collection and insert a user:

```javascript
db.users.insertOne({ name: "Alice", age: 30, city: "New York" })
```

### Find Documents

To retrieve documents from a collection:

```javascript
db.users.find() // Retrieves all documents in the 'users' collection
db.users.find({ city: "New York" }) // Retrieves users from New York
```

### Exit the Shell

To leave the `mongo` shell:

```javascript
exit
```

## Managing the MongoDB Service

You can manage the MongoDB service using `systemctl` commands.

* **Start:** `sudo systemctl start mongodb`
* **Stop:** `sudo systemctl stop mongodb`
* **Restart:** `sudo systemctl restart mongodb`
* **Status:** `sudo systemctl status mongodb`
* **Enable on boot:** `sudo systemctl enable mongodb`
* **Disable on boot:** `sudo systemctl disable mongodb`

## Troubleshooting Tips

* **Connection Refused:**
* Ensure the MongoDB service is running (`sudo systemctl status mongodb`).
* Check the `bindIp` setting in `/etc/mongod.conf`. If connecting remotely, it must not be `127.0.0.1` unless you are using SSH tunneling.
* Verify your server's firewall rules allow traffic on port 27017.
* **Authentication Errors:** If you've enabled authentication (not covered in this basic guide), ensure you are providing the correct username and password.
* **Disk Space:** MongoDB can consume significant disk space. Monitor your server's disk usage. Consider [[SSD Hosting|SSD hosting]] for better I/O performance.
* **Logs:** MongoDB logs are typically found in `/var/log/mongodb/mongod.log`. Check this file for detailed error messages.

## Related Articles

* [[Firewall Configuration]]
* [[SSH Security Best Practices]]
* [[Dedicated Servers]]

## Conclusion

You have successfully installed and performed basic configuration for MongoDB. This setup provides a robust foundation for your NoSQL applications. For more advanced configurations, security, and performance tuning, consult the official MongoDB documentation.

[[Category:Database Setup]]
[[Category:Linux Administration]]
[[Category:NoSQL]]

Installing MongoDB - Revision history

Admin: New server guide