Mendix 7 is no longer supported unless you have Extended Support (for details, please contact Mendix Support). Mendix 7 documentation will remain available for customers with Extended Support until July, 2024.

Debug Microflows Remotely

Last modified: March 22, 2024

1 Introduction

It is possible to debug applications that are already in the cloud (either in an acceptance or production environment).

This how-to teaches you how to do the following:

Connect your debugger to your cloud environment

2 Prerequisites

Before starting this how-to, make sure you have completed the following prerequisites:

Install a Basic, Professional, or Enterprise Mendix edition: http://www.mendix.com/editions/

3 The Basics

To enable the cloud debugging, you need to get a URL and a password from the cloud and add that information to the Modeler. The steps below will explain where you can gather all the necessary information.

The debugger supports only debugging of single-instance environments. Multi-instance environents need to be scaled down to one instance before the debugger can be used.

Debugging in production is not recommended. However, if you are debugging in the cloud, be aware of other system end-users. The debugger will stop processes from moving on for other users.

3.1 Enabling Debugging in the Cloud

Open your browser, go to the Developer Portal, and log in with your Mendix ID.
Click Apps and navigate to the project that you want to debug:
Click Environments in the navigation pane. On the Deploy tab, click Details for the environment:
On the Environment Details screen, click Enable Debugging:

This invokes the Debugger settings pop-up window. Usually, this presents a URL (such as http://yourapp.mendixcloud.com) and a secure password that changes each time you enable and disable the debugger:

If you want to disable the debugger, click Disable Debugging on the Environment Details screen.

3.2 How to Enable Cloud Debugging in Your Modeler

Once you have the unique URL and password, there are two methods for connecting the modeler to the cloud environment.

If you do not see an overview similar to the one below, then you do not have sufficient cloud permissions to deploy packages into the cloud or to debug in the cloud. Contact the Technical Contact or the project Scrum Master in your project to get sufficient permissions.

3.2.1 First Method for Connecting the Modeler to the Cloud Environment

Go to the Run tab and select Connect debugger…:
In the Connect Debugger dialog box, enter the URL and the Password that you got from the cloud environment (for details, see 3.1 Enabling Debugging in the Cloud):

3.2.2 Second Method for Connecting the Modeler to the Cloud Environment

Go to the Debugger dock window.
Click Connect and enter the URL and password information in the dialog window.