Private Mendix Platform User Guide

Last modified: September 22, 2026

Introduction

See the following articles for information about the business-as-usual use cases available for Private Mendix Platform.

Configuring Your User Profile and Settings

Your user account is created by the administrator of your Private Mendix Platform. After you log in for the first time, you can configure some of your profile settings by clicking the user icon in the top right corner of the screen, and then selecting Manage My Account from the drop-down.

Profile

In the Profile tab, you can configure general information about yourself. This includes the following information:

Full name (for example, Jane Doe)
User name (for example, jdoe)
Display language

You cannot change your email, user role, or user group. If this information must be updated, contact your Private Mendix Platform administrator.

Change Password

In the Change Password tab, you can set a new password for your account. The password must fulfill the following criteria:

Minimum of 8 characters
Contains an uppercase letter
Contains a number
Minimum one special character

Personal Access Tokens

Personal Access Tokens (PATs) are used as alternatives to passwords. They are designed to be used when the client application needs to get access on behalf of a specific platform user, but the user is not “present” at the time of access, so the user cannot login via a browser (web SSO). The client application can be any application (meaning, even an app not built with Mendix).

For more information about Personal Access Tokens, as well as creating and using them, see Personal Access Token.

Service Credentials

In the Service Credentials tab, you can view and manage the credentials for various external systems that Private Mendix Platform can connect with. These services include GitHub, GitLab, Bitbucket, and AzureDevOps, used for managing your app projects.

To create or work on app projects in Private Mendix Platform, you must create an access token in GitHub, GitLab, AzureDevOps, or Bitbucket, and then add it in the Service Credentials tab. The token must have read and write access to a repository where the app project is stored.

Installing Mendix Studio Pro

Before you can create your first app, you must first install Mendix Studio Pro by performing the following steps:

Log in to Private Mendix Platform.
On the home page, click Download Studio Pro and Download Studio Pro Patch file.
Install Studio Pro. For more information, see Installing Studio Pro.
Extract the Studio Pro patch file to the modeler directory located in the Studio Pro installation directory, and let it patch the files inside.
Launch Studio Pro and log in to it with the same credentials as for Private Mendix Platform.

Creating a New App

To create a new app, perform the following steps:

Log in to Private Mendix Platform.
If you have not already configured an access token for a GitLab, GitHub, AzureDevOps, or Bitbucket repository, click the user icon in the top right corner of the screen, and then click Manage My Account > Service Credentials.

For more information, see Service Credentials.
On the home page, click Create App Project.
Start the creation of your app by selecting a template.

For step-by-step examples and guides for new Mendix developers, refer to the following pages:
- Quick Starts
- Learning path: Become a Rapid Developer

Managing Your App

As a user of Private Mendix Platform, you can view the apps that you own directly on the home page of Private Mendix Platform.

This includes the apps that you created, as well as the apps that are shared with your user group. To view more details about an app, click on its tile.

In the General section, you can you can quickly perform a number of actions:

Edit details such as app name and description
Invite users to work on the app
View the Git revisions per branch for the app
Assign the app to a new owner or group
Archive the app, provided you are the only team member. You will be warned of the consequences and asked for confirmation before the app is archived.
Delete the app, provided you are the only team member. You will be warned of the consequences and asked for confirmation before the app is deleted.

Deploying Your App

In the Deploy section, you can configure the environment to which your app will be deployed.

Optional: In the Environments tab, create a new deployment package.
Click Create Environment.
Select your deployment package that you want to deploy to this environment, and then click Next.
Specify the following details about the environment:
- Internal Name - An automatically generated internal name for the environment. The environment name can only contain lowercase letters and numbers.
- Display Name - The name that will be displayed in the UI. You can have several environments for your app, for example test, acceptance, and production.
- Cluster and Namespace - An existing cluster and its namespace.
Click Next.
After the environment is created, you can use the Details menu to perform additional actions such as deleting the environment, or starting and stopping the app.

Deployment Purpose and DTAP Mode

When creating a new environment to deploy, you can select the environment purpose, which can be Development, Test, Acceptance, or Production. For the deployed Mendix App, this purpose corresponds to the runtime's dtapMode, which affects security and licensing. For example, whether demo users are available after deployment, whether production security is enabled, or whether the environment requests a license from the license manager service. Once the environment has been created, the environment purpose cannot be changed.

On Private Mendix Platform, environments with the Development and Test purpose set the dtapMode to D (for Development), while Acceptance and Production environments operate in dtapMode P (for Production). This association cannot be changed. Please select the appropriate environment purpose when you're creating a new environment.

Managing Marketplace Content

If your organization has enabled the Marketplace for your Private Mendix Platform, you can build your own connectors and modules, and then share them on the Marketplace, so that other teams from your organization can use the connector in their own apps.

Creating Marketplace Content

For more information about building a connector for your Mendix app, see the following topics:

To share the connector that you built, perform the following steps:

In Private Mendix Platform, click My Content.
Select a Content type for your component.
On the General page, enter a Name for your component.
Enter a Description of your component.
Select the Studio Pro Version for which the component is built.
Select the type of License you want applied to your app.
Select the Cover Image that will be displayed for your connector.
Click Continue.
On the Package page, in the Upload MPK field, click Browse and select the .mpk file that you created for your component.
Click Upload.
Specify the Version of your component.
Provide a Release Note to describe the contents of the version you are uploading.
Click Save & Continue.
On the Additional Info page, provide instructions for users of your component.
Click Save & Continue.
Review and publish your changes.

Depending on the process set up by your Private Mendix Platform administrator, your component may be subject to an approval process before it is shared with other users.

On the Manage Group Content page, you can share components with the user groups to which you belong.

In Private Mendix Platform, click Group Content.
Select a Content type for your component.
In the App Visibility section, select the group with which you want to share the component.

If the group with which you want to share the content is not in the list, it means that you are not a member of that particular group. Contact your Private Mendix Platform administrator.
Follow the instructions in Sharing Marketplace Content.

Monitoring

"Grafana, Loki, and Prometheus are the recommended monitoring stack for Kubernetes-based services like Private Mendix Platform. The customer is responsible for configuring the stack. For more information, see Grafana Integration for Private Mendix Platform.

Logs & Events

From the Logs page, you can access the logs produced by your app. For information about configuring

To access the logs, perform the following steps:

Open your app in the Private Mendix Platform portal.
In the left navigation pane, click Monitoring > Logs & Events.
Select the environment for which you want to view the logs.

You can filter the results by the following properties:

Container - The container instance.
Retrieve last - The number of results to retrieve.
Timespan - The date and time range to display.
Filter by Log Level - The highest log level to display. The following log levels are available:
- Trace - Provides highly detailed information. Trace level messages are written only to logs.
- Debug - Provides detailed information, typically of interest only when diagnosing problems.
- Info - Confirms that things are working as expected.
- Warning - Indicates that something unexpected happened or warns about an upcoming problem (for example, disk space low). The application is still working as expected.
- Error - Indicates a serious problem that prevented the application from performing some function.
- Critical - Indicates that a serious error has occurred; the application may be unable to continue running.
Keyword - A keyword to use for filtering.

Help Me Function

On the Logs & Events page, you can also download the Help Me package, containing diagnostic logs which you can attach to a support ticket if needed. For more information about the Help Me function, see Private Mendix Platform Events and the Help Me Function.

Metrics

The Metrics page contains detailed graphs about your app and its environment. You can use this page to monitor the performance and health of your app; for example, you can track the usage growth of your app or debug performance problems.

These statistics are displayed as trends over time.

To view the graphs on Metrics page, perform the following steps:

Open your app in the Private Mendix Platform portal.
In the left navigation pane, click Monitoring > Metrics.
Select the environment and pod.