Instance Restart

Enterprise Feature

Please note that this feature is only included in the enterprise edition of Camunda 7, it is not available in the community edition.

Check the Camunda enterprise homepage for more information or get your free trial version.

In the history view, you can restart process instances individually or by a batch operation. A restart can consist of one or multiple of the following operations:

  • Restart before an activity
  • Restart after an activity, on its single outgoing sequence flow

Perform Restart

A restart of a terminated process instance includes instructions which are displayed in the bottom of the screen, after you have selected the restart tab in the history view (1).

To add an instruction, hover over an activity in the process diagram. By using the modification button (2), you can select the instruction to be performed with this activity.

In the top-left corner of the activity, a badge will appear, indicating the restart (3).

At any point during the creation of the restart, you can show the payload by clicking the button. This will show the request payload that will be sent via the REST API.

Restart Instructions

When restarting a process instance, you have the option to start before or start after the activity. Using start before, the activity will be executed. start after is only possible if there is only one sequence flow going out of the activity.

Instance selection

When you click on Select Instances, a modal opens. Initially, all instances are displayed. You can use the filter bar above the list of instances to filter the displayed instances. You can select specific instances or click on the Query radio button to select all instances matching the filter.


Selecting all instances might create a high load on the database and application runtime/server if the query has a high number of results.

When you have made your selection you can proceed by clicking the red button. This leads you to the Confirm Restart modal.

Confirm Restart

Here you see two sections. The option section allows you to specify options related to the execution of the restart.

Asynchronous is recommended to keep ticked when you want to process a large number of instances. Otherwise, unchecking the box allows you to process the batch in a synchronous manner.

Initial Variables allows you to set the initial set of variables. By default it is the last set of variables used.

Without Business Key offers the option to avoid taking over the business key of the historic process instance to the new instance.

Skip Custom Listeners and Skip IO Mappings make it possible to skip invocations of execution and task listeners as well as input/output mappings for the transaction that performs the restart. This can be useful when the restart is executed on a system that has no access to the involved process application deployments and their contained classes.

The second section shows an summary over the operations and number of instances you have specified before.

On this Page: