MongoDB Setup

This document was migrated from DigiDocs

The purpose of this guide is to quickly set up a local copy of MongoDB on Windows for local development purposes. Authentication will not be enabled or covered in this tutorial.

Installation and config#

  1. Install MongoDB Community Edition, the standard configuration is fine.
  2. Take note of where your installation's bin folder is at, it should be at C:\Program Files\MongoDB\Server\4.2\bin by default.
  3. Add it to your environment variables. See guide here.
  4. Open your terminal - if you already have it opened, exit and re-open it to reload the enviroment variables.
  5. Enter mongo to access MongoDB.

Create a new collection#

  1. Next, create a new collection, use the use command:
# To display the database you are using
# To switch databases use `use <database>`
# To create a new database, switch to a non-existing database
use dev
# Template
use <database>

Read for more information.

Create a new user#

  1. Next, create a user with readWrite and dbAdmin roles, using the db.createUser() command:
# Switch to the database you want to add the user to
use dev
# Create the user with `readWrite` and `dbAdmin` rights
user: "devadmin",
pwd: passwordPrompt(),
roles: [ "readWrite", "dbAdmin" ]
# Template
user: <username>,
pwd: <password>,
roles: [ "readWrite", "dbAdmin" ]

connection-string format#

The connection-string is used to access the MongoDB instance from your applications (i.e. MongooseJS). The format of your connection-string is as follows:

# Parts in [ and ] are optional
# Example, without authentication
# Example, with authentication
# Replace the <password> with your actual password

If the username or password includes the at sign @, colon :, slash /, or the percent sign % character, use percent encoding. See for more information.


Given that we are not enabling authentication, you can use either of the above connection-string URI formats.

Verify connection-string#

To verify your connection-string, simply use mongo <mongoURI>:

# Example, without authentication
mongo mongodb://localhost:27017/dev
# Example, with authentication
mongo mongodb://devadmin:<password>@localhost:27017/dev