Mendix allows you to build Free Apps which give you the opportunity to try things out and to build and test apps using all the functionality of Mendix. You can deploy these to the Mendix Cloud, or to another public or private cloud of your choice, for example SAP Cloud Platform.
However, Free Apps are restricted in how long they run; they will stop running after around 2 hours. If they are run outside the Mendix Cloud, they cannot have more than ten users. There are also restrictions on how they can be configured. A full list of restrictions is available in Mendix Cloud – note that some of these restrictions are specific to Free Apps running on Mendix Cloud.
To use your app in a production environment, you need to license it. The method for doing this differs depending on the environment to which you are deploying your app.
The app will check for a license each time it is started.
2 Obtaining a Mendix License
For all deployment options, apart from IBM Cloud Portal, you will need to obtain a Mendix license from Mendix support. See IBM Cloud Portal, below, for more information on how to license apps deployed to the IBM Cloud Portal.
If you need a Subscription Secret to deploy to SAP Cloud Platform you will need to create a ticket with Mendix Support.
If you want to create a new licensed node in the Mendix Cloud and your contract does not allow for more licensed nodes, please contact your Customer Success Manager (CSM) first.
For all other license requests, do the following:
Open the Request New App Node app.
Fill in the basic information, such as app name and hosting type.
Provide additional information about your app, if required by the type of hosting. For example, you will need to provide the server id if you are deploying the app locally on a Virtual Machine.
Save the app details.
Mendix Support will contact the technical contact via a ticket in the Support Portal.
If you are hosting your app outside the Mendix Cloud, Mendix support will provide you with two parts to your key: * LicenseId – this is a unique identifier for your license, based on where it is being deployed. * LicenseKey – this is a base64 string.
An example LicenseId is aab8a0a1-1370-467e-918d-3a243b0ae160. LicenseKey is a very long base64 string.
3 Activating a Mendix License
3.1 Mendix Cloud
To run Mendix apps in production on the Mendix Cloud, they must be linked to a licensed node in the Mendix Cloud. This process is described in a separate document: Licensing Mendix Cloud Apps.
3.2 SAP Cloud Platform
To license a Mendix app on SAP Cloud Platform, you need to supply a Subscription Secret which is linked to your app.
You can add this subscription secret as part of creating an environment on SAP Cloud Platform. You can also add, or change, the subscription secret on the Environment Details page of the environment you wish to license.
For more information, see SAP Cloud Platform - deploy.
3.3 Siemens MindSphere
To license a MindSphere app, you need to provide your License ID and License Key as Cloud Foundry environment variables. See Cloud Foundry, below, for instructions on how to do this.
3.4 Cloud Foundry
To activate a license on your app running on Cloud Foundry you need the license credentials provided by Mendix Support.
The two environment variables
LICENSE_KEY need to be set to the values of the LicenseId and LicenseKey provided by Mendix Support. This is done through the following two commands.
cf set-env <YOUR_APP> LICENSE_ID <LicenseId> cf set-env <YOUR_APP> LICENSE_KEY <LicenseKey>
<YOUR_APP> is the name of your app.
The app needs to be restarted for the environment variables to be read and the license to become effective.
To activate a license on your app running in a Docker container you need the license credentials provided by Mendix Support.
Two additional environment variables,
LICENSE_KEY, need to be set to the values of the LicenseId and LicenseKey provided by Mendix Support. This is done by adding them to the startup command for your container.
docker run -it \ … \ -e LICENSE_ID=<LicenseId> \ -e LICENSE_KEY=<LICENSE_KEY> \ mendix/mendix-buildpack:…
3.6 Windows Server
To license a Mendix app on Microsoft Windows you need to:
- Obtain the server id of your server.
- Request a license key from Mendix Support.
- Insert the license key on the server.
Full instructions on how to do this can be found in MS Windows: Activate a Mendix License on Microsoft Windows.
3.7 Unix-like Server
To license a Mendix app on Linux, or another Unix-like operating system, you need to:
- Open the interactive m2ee console.
- Use the command
show_license_informationto obtain the server id of your server.
- Request a license key from Mendix Support.
- Activate your license on the server using the m2ee command
More instructions on how to do this can be found in Unix Deployment.
3.8 IBM Cloud Portal
To license a Mendix app on IBM Cloud Portal, you need to bind the Mendix Platform Service on the IBM Cloud Portal to your app.
This process needs to be done through the IBM Cloud Portal and is documented in Mendix Platform in the IBM Cloud documentation.