Deployment Package

<< Click to Display Table of Contents >>

Navigation:  Automation Service Management > How to manage your environment with Management Console Web > Environment >

Deployment Package

Deployment package lets you apply a deployment package into a target environment (e.g, testing or production).




How to import a development package

Follow these steps to import a deployment package.


1. Click Upload new package to upload the deployment package




2. Select the .bex file containing the deployment package.

Note that the file name given has no functional significance. However, make sure you are uploading the correct file.




3. Double-check and explicitly confirm this action by clicking Upload package.




Uploading and applying the package involves importing processes, and may take a few minutes:




Once the upload is complete and successful, the package details appear. You can see the content of the package using the package visualizer to see its content using the View content button or cancel the upload.




Click Import if you want to apply the given package in your environment. A window appears showing that this procedure will start the Maintenance Window.

You can click Object list to see the objects included in the packages that have changed.



Bizagi has some configurations that can be managed per environment directly from the Management Console (e.g., environment configuration, authentication and authorization configuration, and external systems). Other setups done in the Work Portal such as Live Processes, theme builder and localization, are also independent per environment.


If a deployment package contains metadata related to parameters or environment's configuration, this is only applied to the environment in the first deployment. Subsequent deployments do NOT replace these metadata, because the configurations must be done directly in the environment through the Management Console or the Work Portal. Furthermore, these configurations override any deployment package settings.


Click Import package to confirm.




Once the procedures is complete and successful, its details are added to the deployment history with status Done. Otherwise, an error message appears.


Zero Downtime Deployment

Any deployment does not need any maintenance window or any reset in the environment. The maintenance window is automatically activated in the following scenarios:

first deployment

if the content of the .bex file contains environment configurations.

If you deploy component libraries.

If you deploy library rules.


If the .bex file does not match any of the scenarios mentioned, you can apply the package without stopping the environment. That is, current sessions and the execution of the Work Portal for end-users are not affected, and they can continue working on the environment while the package is imported.



For changes in processes that are critical or important, it is suggested to perform a reset of the environment. For example, if you change attribute types, validation rules, or rules that affect the flow of the process.

Be careful when you deploy changes that affect the execution of tasks or processes. For example, if you change an attribute type in the deployment, it is possible that rules or execution of forms are affected. If this issue is presented to a user, after deployment, it is recommended that the user refreshes the whole site, so the form loads new changes after the cache has been flushed.


Deployment history

The Previous processes table shows you the previous deployments performed. This table has the following columns:




File name

Name of the deployment package.

Load status

Defines the result of the package upload. Possible values are Error and Done.

Uploaded by

Name of the users who uploaded the deployment package.

Uploaded date

Date when the deployment package was uploaded.

Upload Time

Time when the deployment package was uploaded.

View content

Opens the package visualizer to see the content of the deployment package. This option is available when the package was successfully applied.


Downloads a copy of the deployment package. This option is available when the package was successfully applied.