27th June, 2016 | Tutorials |

Create A MongoDB Docker Container with Attached Storage Volume

Need Hosting? Try ours, it's fast, reliable and feature loaded with support you can depend on.

View Plans

Docker is an open-source project that automates the deployment of applications inside software containers.

MongoDB is an open-source document database and leading NoSQL database. MongoDB is written in C++.


Docker containers wrap up a piece of software in a complete filesystem that contains everything it needs to run: code, runtime, system tools, system libraries - anything you can install on a server. This guarantees that it will always run the same, regardless of the environment it is running in.

MongoDB is document database in which one collection holds different different documents, which makes it schema less. Number of fields, content and size of the document can be differ from one document to another. It also has deep query-ability. MongoDB supports dynamic queries on documents using a document-based query language that's nearly as powerful as SQL. MongoDB is easy to scale & conversion / mapping of application objects to database objects is not needed. It uses internal memory for storing the (windowed) working set, enabling faster access of data.

Using Docker and containers for deploying MongoDB instances will bring several benefits, such as:

In this tutorial, we will learn how to build a Docker image with MongoDB.


Create a Docker Container

Create a directory in which we will write Dockerfile and keep all configuration files in it, if required.

sudo mkdir /Docker cd /Docker

Create a file named Dockerfile using the following command,

sudo nano Dockerfile

Add following content into the Dockerfile.

    FROM ubuntu
    MAINTAINER Firstname Lastname

RUN apt-key adv --keyserver hkp:// --recv 7F0RBB10 && echo 'deb dist 10gen' | sudo tee /etc/apt/sources.list.d/mongodb.list && apt-get update && apt-get install -y mongodb-org

VOLUME ["/data/db"] WORKDIR /data

EXPOSE 27017

CMD ["mongod"]

Save and exit the file.

The following is an explanation of what we used to build the Dockerfile.

After creating the Dockerfile, you can build the image by running following command.sudo docker build -t mongodb

Run docker images command and verify your Docker image is in the list.

sudo docker images

You should see the following output:

    REPOSITORY                  TAG                 IMAGE ID            CREATED             SIZE
    frodenas/mongodb        latest      e17b56e5200a        5 seconds ago   235.3 MB
    firefox-instance            latest              8e61bff07fa0        4 weeks ago         354.6 MB
    centos                      latest              d0e7f81ca65c        4 weeks ago         196.6 MB
    debian                      latest              f50f9524513f        5 weeks ago         125.1 MB
    apache/ubuntu               latest              196655130bc9        5 weeks ago         224.1 MB
    apache-instance             latest              7da78270c5f7        5 weeks ago         224.1 MB

Next, start the docker container by running the following command:

docker run --name mongo-dev -d -v /opt/mongodb:/data/db -p 27017:27017 mongodb

Run docker ps to check the container status. We have mapped MongoDB port 27017 of container to local host's port 27017 while starting container.

To verify MongoDB, Let's try to connect to the server and create a new db with a record. We will need the mongo client tools installed to issue the next commands.

Run following command to connect to MongoDB server running inside Docker container,

mongo localhost:27017

You should get a Mongo prompt after running above command.

Create new database,

use mynewdb

Now let's use MongoDB's sample data script to populate a testData collection,

    for (var i = 1; i <= 15; i++) {
       db.testData.insert( { x : i } )

Now, query the data,


To exit the MongoDB shell,


Now, let's check that the instance of MongoDB container has db files outside of the container by running ls on /opt/mongodb. You should see similar output shown below.

journal local.0 local.ns mongod.lock _tmp mynewdb.0 mynewdb.ns

Now check what happens when the container is restarted?

sudo docker restart mongo-dev

Now try to re-connect to MongoDB and validate the data exists.


In this tutorial we learned to create a MongoDB Docker container and store the data in a volume which stores the persistent data across container restart.

Need Hosting? Try ours, it's fast, reliable and feature loaded with support you can depend on.

View Plans