MongoDB Server

MongoDB is used to support automations in Harmony. You can either install MongoDB Server locally or run a MongoDB docker container, it's up to you. The only thing you need to configure is the MongoDB connection string in the appsettings.json file in the Harmony.Api & Harmony.Automations projects. The following configuration connects to a local MongoDB server instance.

  "MongoDB": {
    "ConnectionURI": "mongodb://localhost:27017"
  },

You don't have to create the database manually, when you fire up Harmony.Automations, it will automatically create the database and seed some automation templates for you. Then you can access a board's automation settings page and configure automations for a project.

MongoDB automation templates

Communication between Harmony.Api & Harmony.Automations

The only app that has direct access to the harmony_automation database is the Harmony.Automations. For this reason it exposes HTTP endpoints that can be used for creating, editing and deleting documents.

You need to set the Harmony.Automations endpoint to the appsettings.json file of the Harmony.Api project.

  "AppEndpointConfiguration": {
    "AutomationEndpoint": "https://localhost:7277/"
  },

In case Harmony.Automations uses a different port, update the value of the AutomationEndpoint property

Read next - Configure Redis

Redis