· 6 min read

Quickstart Guide: Running MongoDB with Docker

In this guide, we will explore how to get started with MongoDB using Docker. Docker is a popular tool for containerization, which allows developers to package an application with all of its dependencies into a standardized unit for software development. MongoDB, on the other hand, is a source-available cross-platform document-oriented database program. By combining these two powerful technologies, we can quickly set up a MongoDB server for development or testing purposes. We will walk through the steps of setting up the MongoDB container, interacting with it, creating a Dockerfile for MongoDB, building the Docker image, and finally, deploying the MongoDB instance as a daemon process. Let’s dive in!

Setting Up MongoDB Container

Setting up a MongoDB container using Docker is straightforward. First, you need to pull the MongoDB image from Docker Hub using the command docker pull mongo. This will download the latest official MongoDB image to your local machine.

Once the image is downloaded, you can start a MongoDB container with the command docker run --name some-mongo -d mongo:tag. Replace some-mongo with the name you want to assign to your container and tag with the version of MongoDB you want to use.

The -d option tells Docker to run the container in detached mode, meaning it runs in the background and doesn’t output logs to the console. If you want to see the logs, you can use the command docker logs some-mongo.

Now, you have a running MongoDB container. In the next section, we will discuss how to interact with this container.

Interacting with MongoDB Container

Interacting with a MongoDB container is done through the MongoDB shell, an interactive JavaScript interface to MongoDB. You can start the MongoDB shell with the command docker exec -it some-mongo mongo.

Once inside the shell, you can interact with your MongoDB instance. For example, you can list all databases with the command show dbs, switch to a database with the command use <database>, and list all collections in the current database with the command show collections.

You can also perform CRUD (Create, Read, Update, Delete) operations from the MongoDB shell. For example, to insert a document into a collection, you can use the command db.collection.insertOne({}), replacing collection with the name of your collection and {} with the document you want to insert.

Remember to exit the MongoDB shell when you’re done interacting with your database. You can do this by typing exit at the MongoDB shell prompt. In the next section, we will discuss how to create a Dockerfile for MongoDB.

Creating a Dockerfile for MongoDB

Creating a Dockerfile for MongoDB allows you to customize your MongoDB container. A Dockerfile is a text document that contains all the commands a user could call on the command line to assemble an image.

Here’s a simple example of a Dockerfile for MongoDB:

# Use an official MongoDB runtime as a parent image
FROM mongo:latest

# Set the working directory in the container to /data/db
WORKDIR /data/db

# Expose port 27017 to have MongoDB listen for connections from applications
EXPOSE 27017

# Run MongoDB when the container launches
CMD ["mongod"]

This Dockerfile does the following:

  • It starts from the mongo:latest image, which is the official MongoDB image from Docker Hub.
  • It sets the working directory in the container to /data/db. This is where MongoDB stores its data.
  • It exposes port 27017, which is the default port that MongoDB listens to for connections from applications.
  • Finally, it runs the mongod command when the container launches, which starts the MongoDB server.

You can build a Docker image from this Dockerfile with the command docker build -t some-mongo ., replacing some-mongo with the name you want to give to your image. The . at the end of the command tells Docker to look for the Dockerfile in the current directory.

In the next section, we will discuss how to build the MongoDB Docker image.

Building the MongoDB Docker Image

Building the MongoDB Docker image is the next step after creating your Dockerfile. This process converts the text file into an executable Docker image, making it ready for use.

You can build the Docker image using the docker build command. Here’s how you can do it:

docker build -t my-mongo-image .

In this command, -t my-mongo-image assigns the name my-mongo-image to your new Docker image. The . tells Docker to look for the Dockerfile in the current directory.

Once the build process is complete, you can verify that the image was created successfully by running the docker images command. You should see my-mongo-image in the list of Docker images on your machine.

Now, you have a Docker image for MongoDB that’s ready to be run as a container. In the next section, we will discuss how to deploy this MongoDB instance as a daemon process.

Deploying MongoDB Instance as a Daemon Process

Deploying your MongoDB instance as a daemon process means running it in the background, which is ideal for production environments. You can do this using the docker run command with the -d option, which stands for “detached mode”.

Here’s how you can do it:

docker run -d --name my-mongo-container my-mongo-image

In this command, my-mongo-container is the name you want to assign to your new container, and my-mongo-image is the name of the Docker image you created earlier.

Once the command is executed, Docker will return the long container ID for your new MongoDB instance. You can verify that the container is running using the docker ps command.

Now, your MongoDB instance is running as a daemon process. You can connect to it from your application using the standard MongoDB connection URI: mongodb://localhost:27017.

Remember, when you’re done with your MongoDB instance, you can stop it using the docker stop command followed by either the container ID or the name of the container.

And that’s it! You’ve successfully deployed a MongoDB instance as a daemon process using Docker. In the next section, we will wrap up and discuss next steps.

Conclusion and Next Steps

Congratulations! You’ve successfully set up and interacted with a MongoDB instance using Docker. This setup is ideal for both development and testing environments. With the knowledge you’ve gained, you can now easily spin up a MongoDB server whenever you need one.

As next steps, consider exploring more advanced MongoDB features, such as setting up a MongoDB replica set or sharded cluster. You might also want to look into how to persist data in Docker, which is crucial if you’re planning to use Docker for running MongoDB in production.

Remember, the key to mastering any technology is practice. Don’t hesitate to experiment and try out different things. Happy coding!

    Share:
    Back to Blog