Install MongoDB Enterprise with Docker

On this page

Considerations

Create a Docker Image with MongoDB Enterprise
Push the Image to Docker Hub

Important

The recommended solutions for using containers with MongoDB are:

For development and testing use the MongoDB Community Docker container. This image is supported by MongoDB. The image contains the Community Edition of MongoDB.
For MongoDB Enterprise production installations, use MongoDB Ops Manager to configure Docker containers and Kubernetes.

To manually configure MongoDB Enterprise with Docker, follow the instructions on this page.

Considerations

A full description of Docker is beyond the scope of this documentation. This page assumes prior knowledge of Docker.

This documentation only describes installing MongoDB Enterprise with Docker, and does not replace other resources on Docker. We encourage you to thoroughly familiarize yourself with Docker and its related subject matter before installing MongoDB Enterprise with Docker.

Important

This procedure uses the official mongo image. The image is supported by MongoDB.

The MongoDB community may contribute additional container images. For a listing of all available images, see the repository.

Create a Docker Image with MongoDB Enterprise

Install Docker and set up a Docker Hub account before creating a MongoDB Enterprise Docker image.

Download the Docker build files for MongoDB Enterprise.

Set MONGODB_VERSION to a MongoDB major version:

export MONGODB_VERSION=5.0

Download the build files from the Docker Hub mongo project:

curl -O --remote-name-all https://raw.githubusercontent.com/docker-library/mongo/master/$MONGODB_VERSION/{Dockerfile,docker-entrypoint.sh}

Build the Docker container.

Use the downloaded build files to create a Docker container image wrapped around MongoDB Enterprise. Set DOCKER_USERNAME to your Docker Hub username.

export DOCKER_USERNAME=username
chmod 755 ./docker-entrypoint.sh
docker build --build-arg MONGO_PACKAGE=mongodb-enterprise --build-arg MONGO_REPO=repo.mongodb.com -t $DOCKER_USERNAME/mongo-enterprise:$MONGODB_VERSION .

Verify the build results.

Verify that the image was created:

docker images $DOCKER_USERNAME/mongo-enterprise:$MONGODB_VERSION

The output should resemble:

REPOSITORY                   TAG       IMAGE ID            CREATED          SIZE
username/mongo-enterprise    5.0       bf82d2c5f58d        19 seconds ago   952MB

Test your image.

The following commands:

Run a container using the mongo-enterprise Docker image.
Run mongosh inside the container to verify the MongoDB version.

docker run --name mongoEnt -itd $DOCKER_USERNAME/mongo-enterprise:$MONGODB_VERSION
docker exec -it mongoEnt /usr/bin/mongosh --eval "db.version()" | grep "Using Mongo"

The output should resemble:

 60fbcf88c855e9ae41210422a083314b21a42661a28d970a078ea08ab8bcb06d
 Using MongoDB:              5.0.7
 Using Mongosh:              1.3.1

The displayed values are the:

container ID
MongoDB server version
mongosh version

Push the Image to Docker Hub

Optionally, you can push your Docker image to a remote repository, like Docker Hub, to use the image on other host machines. If you push the image to Docker Hub, you can then run docker pull for each host machine on which you want to install MongoDB Enterprise via Docker. For complete guidance on using docker pull, reference its documentation here.

Check your local images.

The following command displays your local Docker images:

docker images

You should see your MongoDB Enterprise image in the command output. If you do not, try Create a Docker Image with MongoDB Enterprise.

Push to Docker Hub.

Push your local MongoDB Enterprise image to your remote Docker Hub account.

docker login
docker push $DOCKER_USERNAME/mongo-enterprise:$MONGODB_VERSION

If you log into the Docker Hub site, you should see the image listed under your repositories.

← Install MongoDB Enterprise on Windows using msiexec.exeUpgrade MongoDB Community to MongoDB Enterprise →