How to properly use credentials.json file

I’m trying to create the credentials.json file on my atlassian-connect app.

I’ve followed these instructions :

Automatic registration

This section will describe how to configure ACE so that it can automatically register your add-on with your Jira or Confluence host, re-register on changes to the descriptor, and de-register on shut down.

To get this functionality, you will need to:

  • Install ngrok: npm install --save-dev ngrok ,
  • Create a file called credentials.json ,
  • Copy and paste the contents of this file,
  • Add credentials.json to the .gitignore file, and
  • Change the contents of the file to contain the link to your development environment, e-mail as the username, [API token] as password and product name.

ACE will now read this file and automatically create an ngrok tunnel, and register your add-on on your development host.

I’m not entirely sure what is link to my development environment. my credentials.json file currently looks like this :

    "hosts": {
        "https://<username>": { // I'm not sure what should be here..
            "product": "PqXXXX",
            "username": "",
            "password": "PqXXXX"


I was wondering that too. Did you ever find out? The documentation is very ambiguous about this.