MS Windows: Update a Mendix App

Last update: Edit

A Mendix application on a Windows server can be updated using the Mendix Service Console. Before starting with the server update, you need to make sure that you have a versioned deployment archive (*.mda file) accessible on your server and that the same version of the server distribution is either installed or also available as an installation package on the server.

The service console creates a backup of the project files, this allows you to restore a previous deployment. But before every update it is recommended to create a backup of your data and uploaded files. The Mendix Service Console does not do this for you.

1 Using the Update app button

  1. You can update the application by clicking on the button ‘Update app’.

    Step 1, Start the update process

  2. The ‘Update App’ popup that appears shows you the information of the current active software version. The number of the App version shows the release number of the versioned deployment package. This is the release that is currently running on this server.

    Step 2, Release details and overview of all server versions

To update the application press the button ‘Update app’ and select the new deployment archive (.mda)

Step 3, Choose the latest .mda package

This process will copy the new version of the project software into the configured location. All models will be extracted, and a symbolic link to the ‘mxclientsystem’ folder is automatically created so the JavaScript libraries can be easily included without any additional configuration in IIS.

You’ll see an progress bar appear after clicking the ‘OK’ button once the process has been completed the project software version has been updated.

2 Update The Mendix Runtime version

  1. After updating the Mendix application version it could happen that the Service Console shows the message (missing). This would mean that the required server distribution is not installed on the server. Step 4, a missing Runtime version
  2. There are two ways to install the required server distribution:

    1. If you are online and have access to the Mendix Marketplace, click Download server and the correct server distribution will be fetched and installed.
    2. If you are offline or automatic downloading fails click Add Server and select the required server distribution (.tar.gz). The server distribution can be found under the related downloads from the specific Mendix Studio Pro version on The server distribution is a tar.gz file. The Service Console will extract the server distribution to the same folder as the other server distributions.

    After the server distribution is updated you’ll be able to start the Service using the new project and Mendix Runtime version. Step 5, Choose the correct server distribution (.tar.gz)

2.1 Location of the Mendix server distributions

In the Preferences of the Mendix Service Console you can configure the main directory for all applications and server distributions. You can find the installed platform version in the folder /servers. This folder is located directly in the configured base path from the service console.

This should be something like:


3 Read More