Deployed Apps
Introduction
The Deployed Apps Overview page provides a comprehensive view of all the apps deployed within your company. For each deployed app, you can view details such as its name, ID, Technical Contact, status, number of environments, and, if applicable, the number of cloud tokens used.
Additionally, this page allows you to provision and offboard environments for apps on Mendix Cloud, and email or download the license keys for your apps.
If you click the … icon in the upper-right corner, you can access the following pages that allow you to make requests to Mendix Support:
- Resize App – requests a container size change
- Offboard App – requests that an app is offboarded
- Add new App – requests a new app addition
The Deployed Apps Overview page has the following tabs: Mendix Cloud, Free Apps, and Apps with License Keys.
Mendix Cloud
The Mendix Cloud tab gives you an overview of all the apps that are deployed on Mendix Cloud and allows you to manage your cloud resources using the self-service tool.
To activate this capability for your company, contact your Customer Success Manager.
The list on this tab shows the following information:
- App Name – The name of the app. To view the app environment details, click the app name.
- Technical Contact – The registered email address to which license keys are sent. Each app can only have one Technical Contact. If the Technical Contact is not correct, you can change it by clicking the edit icon ( ) next to the email address and selecting a new Technical Contact from the list. After you update the Technical Contact, both the new and the old contact will receive a notification email.
- Status – Indicates whether app is active.
- Env Count – The number of the environments available for the app.
- Credits Used – The total number of credits the app has used.
App Environment Details
When you click the name of an app in the list, a page opens showing the app’s environment details.
The top of the page includes information about the app name, the number of cloud tokens used, and the Technical Contact. There are also labels which indicate whether the app is licensed or active.
In the upper-right corner, above the list, there is the Add Environment button. Click it to add a new environment.
The list shows all the environments available for the app, with the following columns:
- Environment – The name of the environment
- Resource Pack – The selected resource pack for the environment
- Running State – Indicates whether the app is running or not deployed
- Production – Shows whether the environment is a production environment
- URL – The public URL of the environment
- Mendix Version – The Mendix version
- Credits Used – The number of the credits used by the environment
- Action
- Offboard – Clicking this button starts offboarding an environment
Adding a New Environment
To add a new environment for your app, click the name of an app, and then click the Add Environment button. You must specify the following information:
- Environment Name – Enter a name for your new environment. The name must be unique (that is, your app cannot have more than one environment with the same name).
- Resource Pack – Select the resources required for the new environment. The page displays the resources included in each resource pack, and their cost in cloud tokens.
- Production Environment – Indicate whether the environment will be used for production.
Offboarding an Environment
To offboard an environment, click Offboard, which is available for stopped environments. After that, confirm that you have made all the necessary backups, and type Offboard to confirm.
Free Apps
The Free Apps tab shows all the apps deployed to Mendix Free Cloud.
The list shows the following information:
- App Name – The name of the app.
- App ID – The app/project ID.
- Technical Contact – The registered email address to which license keys are sent. Each app can only have one Technical Contact. If the Technical Contact is not correct, you can change it by clicking the edit icon ( ) next to the email address and selecting a new Technical Contact from the list. After you update the Technical Contact, both the new and the old contact will receive a notification email.
- Status – Indicates whether app is active or not.
Apps with License Keys
The Apps with License Keys tab provides an overview of all apps for which license keys have been issued to their respective Technical Contacts. This includes all your apps deployed on Mendix for Private Cloud Standalone, Docker, Cloud Foundry buildpack, and on-premises environments. You can find the latest version of license keys for these app environments here.
License keys are aligned with your Mendix contracts and need to be applied by you to each app. Every app environment (such as test, acceptance, and production) requires its own license key.
Any changes to licenses require the Technical Contacts to reapply license keys to their respective app environments. For example, when contracts are created or renewed, new license keys are automatically generated. Then these new license keys must be applied to the environments of the app for which the contract was changed. For details on how to apply license keys, see the Activating a Mendix License section in Licensing Apps.
On the Apps with License Keys tab, you can do the following:
- View your apps with issued license keys
- See active license keys for all environments of an app
- Delete license keys for environments that are no longer in use
- Resend licenses to the Technical Contacts of your on-premises deployed apps or download all licenses to your local device
- Quickly change Technical Contacts for these apps and resend keys as needed
You can download all the license keys by clicking Download all keys on the right side above the list.
The list shows the following information:
-
App Name – The name of the app. Click the app name to view the app environment details.
The app name shown here is the name that was initially given to the app when the license keys were generated. Your current app name may be different. -
Account Name – The name of the account.
-
Technical Contact – The registered email address to which license keys are sent. Each app can only have one Technical Contact. If the Technical Contact is not correct, you can change it by clicking the edit icon ( ) next to the email address and selecting a new Technical Contact from the list. After you update the Technical Contact, both the new and the old contact will receive a notification email.
-
Created Date – The date the app was originally created.
-
Actions – Clicking any of these icons performs one of the following actions:
- – Emails the app’s license keys to the registered Technical Contact.
- – Downloads the license keys to your local computer. The license keys can then be applied to the app for which they were created.
App Environment Details
After clicking an app name in the list, a page opens displaying the environments associated with that app, along with the license start and end dates. On this page, you can verify the validity of your license keys and download or email them to the Technical Contact of the app.
In the upper-left corner the page, there is the name of the app, the email address of the Technical Contact, and the date that will be used as the license end date when new keys are generated.
To quickly change the Technical Contact for your app, click the edit icon ( ) by the name of the Technical Contact, and then select the new Technical Contact from the list. After you change the Technical Contact, both the new and the old contact will receive a notification email about the change. Each app can only have one Technical Contact.
On the right side above the list, you can see the following buttons:
-
Email Keys – Clicking this emails the license keys of the app to the registered Technical Contact.
-
Download Keys – Clicking this downloads the license keys to your local computer. The license keys can then be applied to the app for which they were created.
The list below show the details of the environments with the following columns:
- Environment – The names of the environments that belong to the app that you selected.
- ServerID – The server IDs used to generate the license keys for each environment.
- LicenseID – The ID of the license that was emailed to the Technical Contact when the license keys were generated. This unique identifier allows you to reference and manage your licenses, ensuring they align with the licenses in your various environments.
- Start Date and End Date – Your license keys are valid between these two dates. An app needs an active contract with a future end date to keep working.
- Actions – Clicking offboards that license from the database. Before the action is completed, a dialog box opens to ask for your confirmation. When the last license of an app is offboarded, the app is automatically offboarded and will no longer show up on the Apps with License Keys tab.
Frequent Asked Questions
How Do We Know If Our Company Has Apps with Issued License Keys?
The latest version of license keys created for the apps are shown on the Apps with License Keys tab on the Deployed Apps page in Control Center.
Several deployment options require the Technical Contact to manually apply license keys to the app environments. For details on how to apply license keys, see the Activating a Mendix License section in Licensing Apps.
In some exceptional cases, the Technical Contact may also receive license keys for other deployment models. As a Mendix Admin, you are aware of these.
Do These Unrecognized Apps and License Keys Belong to Us?
Yes, all apps and license keys visible in Control Center belong to your company. These keys have been requested by the Technical Contact of the apps. If there are apps or app environments that are no longer active, you should delete them from the Apps with License Keys tab on the Deployed Apps page in Control Center.
If you have any doubts, contact Mendix Support.
Why Are Unused or Unrecognized App Names Still in Control Center? How Can We Correct This?
Some apps still appear on the Apps with License Keys tab on the Deployed Apps page in Control Center, because they were not formally offboarded. You can easily offboard these apps by removing the license keys associated with the environments of the app.
Why Are Some Apps Hosted via License Keys Not Shown in Control Center?
There might be multiple reasons for this. However, it is likely that your app is using incorrect license keys for the app environments. To fix the issue, ask the Technical Contacts of these apps do the following:
- Request new license keys for the app environments.
- Download the license keys.
- Reapply license keys for apps with discrepancies. For details on how to apply license keys, see the Activating a Mendix License section in Licensing Apps.
How Can Our License End Date Differ from Our License Keys End Date? How to Correct this?
The end date of license keys is configured to match your Mendix contract end date. These license keys are published in Control Center and have correct dates.
In case of discrepancy, email the license keys to the Technical Contacts of these apps, and ask them to reapply the license keys for the apps with discrepancies. For details on how to apply license keys, see the Activating a Mendix License in Licensing Apps.
Do We Have to Download New License Keys Once We Renew Our Contract?
Upon renewal of a Mendix contract, new license keys will be automatically emailed to the Technical Contacts of the apps. Additionally, you can also download them on the Apps with License Keys tab on the Deployed Apps page in Control Center.
Do We Have to Manually Activate License Keys After Contract Renewal?
Yes, the Technical Contact of the app needs to manually apply new license keys to the app after the contract is renewed. For details on how to apply license keys, see the Activating a Mendix License in Licensing Apps.
What Happens If We Do Not Update Our License Keys After the License Key End Date? Will We Lose Our Data?
After the end date of the license key has passed, your apps enter a 30-day grace period. During this grace period, the app will continue to run normally using the expired license. However, you may notice extra warning messages in the app logs during this period.
If the Technical Contact of the app does not update the license keys by the end of this period, the app may be forcefully stopped by the Mendix runtime. Upon restart, the app will switch to trial mode and will follow the limitations of trial mode. For details of license limitations, see Licensing Apps.
Our App Stopped Working Because the License Key Expired. What Should We Do?
Contact your Customer Success Manager (CSM) to renew your contract.