Skip to main content
Version: Current

Process topology

Topology is a fundamental element of orchestration. It represents the definition of a process that can contain any actions or connectors to communicate with integrated services.

Topology creation

We create the topology in admin using the "+" button in the left sidebar.

New topology button

Topology detail

In the topology detail we find all the tools for modelling it and monitoring its operation. Here we can see the history and running processes, metrics of each node and logs that we define within the topology.

Topology detail

Topology processes

Topology modelling

In the topology detail we have editor which allows us to easily drag and drop model the process. The notation of the editor is based on BPMN. BPMN 2 files can also be imported into Orchesty and used as a basis for topology design.

Topology editor


Orchesty does not work with BPMN notation exactly and does not use all elements of the notation according to its standard. On the other hand, it defines its own elements to match the needs of data integrations.


The created topology must be published to run. Publishing creates a container with a control microservice and queues between the topology nodes. The new topology is published in the disabled state, making it functional but not receiving any messages.


Each published topology can be easily activated and deactivated. The disable action tells the start event not to receive any signals. Also, Cron does not start new processes. Already started processes continue their processing.


Any modification of an already published topology automatically creates a new version of it. Thus, the modification will never affect currently running processes. If a new version of the topology is published and activated, new processes are already routed to the new version. The original version is still running and the active process instances continue to be processed.


Topologies can be exported and imported as an XML file. In this way, for example, topologies can be transferred between development and production environments.


Use the Test button in the action menu to check the availability of all workers used by the topology.


For a better understanding of how to work with topologies, we recommend you check out our tutorials.