Public | Automated Build

Last pushed: 2 years ago
Short Description
Out-of-the-box app-ready MongoDB server with customizable preset database, user and password.
Full Description


Base docker image to run a MongoDB database server with preset database, username and password of your choice.
Based on tutum/mongodb image.

MongoDB version

Different versions are built from different folders.


If you’d like to build the image from its Dockerfile, clone its repo from
To create the image oliverwehn/mongodb, execute the following command on the mongodb folder:

# Build mongodb image using v3.0
docker build -t oliverwehn/mongodb 3.0/.

If you’d go the usual way and just let Docker pull the image from Docker Hub, proceed below.

Running the MongoDB server

Run the following command to start MongoDB:

docker run -d -p 27017:27017 -p 28017:28017


docker run -d -p 27017:27017 -p 28017:28017 \
-e MONGODB_ADMIN_PASS='youradminpass' \
-e MONGODB_USER_NAME='yourusername' \
-e MONGODB_USER_PASS='youruserpassword' \
-e MONGODB_USER_DB='youruserdb' \

If one of the MONGODB_* environment variables isn’t set, it’s default values apply:

  • MONGODB_ADMIN_PASS: random password
  • MONGODB_USER_NAME: 'app_user'
  • MONGODB_USER_PASS: random password
  • MONGODB_USER_DB: 'app'

To get the random passwords, check the logs of the container after first run using:

docker logs <CONTAINER_ID>

You will see an output like the following:

    You can now connect to this MongoDB server using:

        mongo admin -u admin -p '5elsT6KtjrqV' --host <host> --port <port>
        Please remember to change the above password as soon as possible!

        mongo app -u app_user -p 'Hzdf7a8Z' --host <host> --port <port>
        Please remember to change the above password as soon as possible!


In this case, 5elsT6KtjrqV is the password set for admin, Hzdf7a8Z the one for
user app_user on database app.

You can then connect to MongoDB:

mongo admin -u admin -p 5elsT6KtjrqV


mongo app -u app_user -p Hzdf7a8Z


Run MongoDB without password

If you want to run MongoDB without password you can set the environment variable AUTH to specific if you want password or not when running the container:

    docker run -d -p 27017:27017 -p 28017:28017 -e AUTH=no oliverwehn/mongodb

By default is "yes".

Run MongoDB with a specific storage engine

In MongoDB 3.0 there is a new environment variable STORAGE_ENGINE to specific the mongod storage driver:

    docker run -d -p 27017:27017 -p 28017:28017 -e AUTH=no -e STORAGE_ENGINE=mmapv1 oliverwehn/mongodb:3.0

By default is "wiredTiger".

Change the default oplog size

In MongoDB 3.0 the variable OPLOG_SIZE can be used to specify the mongod oplog size in megabytes:

    docker run -d -p 27017:27017 -p 28017:28017 -e AUTH=no -e OPLOG_SIZE=50 oliverwehn/mongodb:3.0

By default MongoDB allocates 5% of the available free disk space, but will always allocate at least 1 gigabyte and never more than 50 gigabytes.

based on tutum-docker-mongodb image by
customized by

Docker Pull Command
Source Repository