Setting Up Solutions

Last modified: May 15, 2025

Introduction

Setting up a Mendix solution is the process of creating your app from the solution package, and configuring it to be compatible with future upgrades.

Prerequisites

To set up a Mendix solution, make sure the following prerequisites are met:

  • Make sure you are using the correct Studio Pro version.
    A solution can only be set up with the Studio Pro version that exactly matches the version used to create it. For example, if Studio Pro 10.0 was used to create the solution, only that version can be used to set up the solution.
  • The solution must be version-controlled with Git so that it is compatible with upgrades.
  • Make sure your repository is empty. It is impossible to initialize a solution on a non-empty repository.

Setup Process

To set up a solution, follow these steps:

  1. Open Studio Pro and import the .mxsolution package:

    Import Solution

  2. Select the target directory for your solution and click OK.

  3. Once the solution is initialized, a special solution-releases branch is created. This branch contains the unchanged version of the solution, as provided by the ISV. You cannot make any changes in this branch, as that would render the solution incompatible with upgrades, or lead to unpredictable errors during upgrades.

Read More