Strapi Open Source API CMS using Azure CosmosDB Emulator

I've recently started looking at Strapi. Their default samples look for MongoDB instances. But I wanted to see if it would work with the Azure CosmosDB Emulator - then how it works with Azure CosmosDB.

So far, it's worked flawlessly...


Once you git clone the samples from the Strapi Samples - you need to edit the database.json file for the environment you're in. For local development, that's going to be development.

In the directory of the sample app hello-world - edit the config\environments\development\database.json file.

For the settings below, run the Azure CosmosDB emulator then launch the Data Explorer - that will show a website with the connection string and key.

Also, create a new Database called strapi with a collection - call it anything as the tool requires it. It can be deleted later as the sample apps from Strapi will create their own collections.


  • PORT - examine the Mongo connection string - you'll see the port near the end prefixed by a : -- in mine it was localhost:10255
  • Database - enter strapi as that was used in the create database / collection before.
  • Username: localhost
  • Password: from the "key" - this is also in the mongo connection string but URL encoded.
  "defaultConnection": "default",
  "connections": {
    "default": {
      "connector": "strapi-mongoose",
      "settings": {
        "client": "mongo",
        "host": "",
        "port": 10255,
        "database": "strapi",
        "username": "localhost",
        "password": "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
        "authenticationDatabase": "",
        "ssl": true
      "options": {}

That's it.