How to Connect Express to MongoDB

How to Connect Express to MongoDB: Step-by-Step Guide

Connecting your Express.js application to a MongoDB database is a foundational step when building modern web applications. This tutorial explains the process clearly, helping you establish a robust database connection using Node.js and the popular Mongoose ODM (Object Document Mapper).

Prerequisites

Node.js and npm: Make sure you have Node.js (https://nodejs.org/ Node.js Official site) installed on your machine.
MongoDB Instance: Have a running MongoDB instance. You can install MongoDB locally or use a cloud solution like MongoDB Atlas (Official site) for free-tier clusters.
Basic Express Application: Familiarity with Express.js and having a basic app setup is helpful. Refer to our how to install Node.js Express post for setup help.

Step 1: Initialize Your Project and Install Required Packages

Create a new folder for your Express project or navigate to your existing project. Run the following commands to install express, mongoose, and optional dotenv for environment variable management:

npm init -y
npm install express mongoose dotenv

Step 2: Setup Your MongoDB Connection String

For MongoDB Atlas or local MongoDB, get your connection URI. It looks like:

mongodb+srv://username:[email protected]/database_name?retryWrites=true&w=majority

Place this URI in a .env file for security:

MONGODB_URI=mongodb+srv://username:[email protected]/mydb?retryWrites=true&w=majority

Step 3: Create Your Express Server and Connect to MongoDB

Create a file called app.js and set up your Express server with Mongoose connection:

require('dotenv').config();
const express = require('express');
const mongoose = require('mongoose');

const app = express();
const port = process.env.PORT || 3000;

// MongoDB connection
mongoose.connect(process.env.MONGODB_URI, {
  useNewUrlParser: true,
  useUnifiedTopology: true,
})
.then(() => console.log('Connected to MongoDB successfully'))
.catch((error) => console.error('MongoDB connection error:', error));

app.get('/', (req, res) => {
  res.send('Hello from Express connected to MongoDB!');
});

app.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

Explanation:

mongoose.connect() establishes the connection using the URI.
We handle success and failure with then() and catch(), logging accordingly.
The server starts listening on the defined port.

Step 4: Test Your Connection

Run your Express app using:

node app.js

If the connection is successful, you should see Connected to MongoDB successfully and the server running message in your console. Visit http://localhost:3000 to see the greeting.

Step 5 (Optional): Define a Mongoose Model and Use It

To use MongoDB effectively, define schemas and models. For example, create a simple User model:

// models/User.js
const mongoose = require('mongoose');

const userSchema = new mongoose.Schema({
  name: String,
  email: String,
  createdAt: {
    type: Date,
    default: Date.now
  }
});

module.exports = mongoose.model('User', userSchema);

In your app.js, use this model to create a user:

const User = require('./models/User');

app.get('/create-user', async (req, res) => {
  try {
    const newUser = new User({ name: 'Alice', email: '[email protected]' });
    await newUser.save();
    res.send('User created successfully');
  } catch (error) {
    console.error(error);
    res.status(500).send('Error creating user');
  }
});

Troubleshooting Tips

Connection Errors: Verify your MongoDB URI is correct and network access (IP whitelist) is set especially if using MongoDB Atlas.
Package Issues: Ensure mongoose version matches your Node.js compatibility.
Environment Variables: Check if .env is loaded by restarting your server after changes.
Server Doesn’t Start: Confirm no other processes use the same port.