Backups for Mendix on Azure

Last modified: July 3, 2025

Introduction

For apps running in Mendix on Azure, the Backups functionality enables you to create and restore database or file document backups. Other backup functionalities, such as uploading and downloading backup snapshots, or scheduling nightly backups, are not yet supported for Mendix on Azure.

Backup snapshots contain both the database and file documents referred to in the database.

Enabling Backups

If you would like to enable creating and restoring backups, select Try new Backup and Restore on the Backups page.

You must have permission to Manage Apps Backups for the namespace.

Creating a Backup

In the Apps page, select your app.
In the navigation pane, click Backups.
Select the environment for which you want to create a backup from the dropdown on the right.

You may not create backups while the environment status is any of the following:

Environment creation is in progress
Environment creation failed
A deployment package is being deployed in the environment
The environment is in transition state (runtime is processing)

Click Create Backup.
To check the status of the backup, see the Status column.

If you want to restart your environment after creating a backup archive, wait until the backup completes. Tables are locked while the database is in the process of creating a backup, so you may receive a timeout error if you try to start your environment while the backup is being created.

Backup Details

You can view details of a backup by clicking More Options ( ) and then Details. The following details are displayed:

Backup Details	Description
Status	The status of the backup (Processing,Failed, or Finished)
Snapshot ID	A unique identifier for the backup snapshot
Created on	The creation date and time of the backup
Deployment Package	The version of the deployment package used during backup creation
Comment	A comment added to the backup

Deleting a Backup

To delete a backup snapshot, perform the following steps:

Click More Options ( ) by a backup that you want to delete.
Click Delete.

The backup file is retained until you delete it from the portal.

Restoring a Backup

You can restore a backup that has been created in your Mendix on Azure environment. Backups from other cloud providers are not supported.

You can only restore a backup if you have Manage Apps Backups and Stop Apps permissions in the respective namespace.

To restore a backup, perform the following steps:

If your app is running, stop it by clicking Stop Application.
Click More Options ( ) by a backup that you want to restore.

If you select a backup snapshot that was originally deployed with a different Mendix version, you will see a warning. You can still restore the data, but you must deploy the same model afterwards.
Click Restore.
Choose the destination environment to which you want to restore the backup snapshot. This allows you to, for example, restore a production environment backup to an acceptance environment.

Do not update the environment while the restore process is in progress.

Your environment details page displays a message while the backup is being restored. After the restore process is completed, the environment activity log shows the status as FINISHED. If a backup restore fails, the backup activity log of your environment shows the status as FAILED.

Known Limitations

If a backup restore fails, all data that was restored until the point of failure is present in the database. This leaves the database only partially restored.
There is currently no API support for the backup and restore process.
The portal interface appears to allow restoring backups across different namespaces, but in reality this operation is unsupported. Backup and restore operations must be performed within the same namespace only.