Skip to content

MongoDB credentials#

You can use these credentials to authenticate the following nodes:

Prerequisites#

  • Create a user account with the appropriate permissions on a MongoDB server.
  • As a Project Owner, add all the n8n IP addresses to the IP Access List Entries in the project's Network Access. Refer to Add IP Access List entries for detailed instructions.

If you are setting up MongoDB from scratch, create a cluster and a database. Refer to the MongoDB Atlas documentation for more detailed instructions on these steps.

Supported authentication methods#

  • Database connection - Connection string
  • Database connection - Values

Refer to the MongoDBs Atlas documentation for more information about the service.

Using database connection - Connection string#

To configure this credential, you'll need:

  • Select Connection String as the Configuration Type.
  • A Connection String: To get your connection string in MongoDB, go to Database > Connect.
    • Select Drivers.
    • Copy the code you see in Add your connection string into your application code. It will be something like: mongodb+srv://yourName:yourPassword@clusterName.mongodb.net/?retryWrites=true&w=majority.
    • Replace the <password> and <username> in the connection string with the database user's credentials you'll be using.
    • Enter that connection string into n8n.
    • Refer to Connection String for information on finding and formatting your connection string.
  • A Database name: this should be the name of the database that the user whose details you added to the connection string is logging into.
  • Select whether to Use TLS: Turn on to use TLS. You must have your MongoDB database configured to use TLS and have an x.509 certificate generated. Refer to MongoDB's x.509 documentation for more information. Add information for these certificate fields in n8n:
    • CA Certificate
    • Public Client Certificate
    • Private Client Key
    • Passphrase

Using database connection - Values#

To configure this credential, you'll need:

  • Select Values as the Configuration Type.
  • The Host for the database
  • The Database name
  • A User ID
  • A user Password
  • The Port to connect over: This should be the port number your server uses to listen for incoming connections.
  • Select whether to Use TLS: Turn on to use TLS. You must have your MongoDB database configured to use TLS and have an x.509 certificate generated. Refer to MongoDB's x.509 documentation for more information. Add information for these certificate fields in n8n:
    • CA Certificate
    • Public Client Certificate
    • Private Client Key
    • Passphrase