Install a flow runtime using Docker-compose
- Last UpdatedAug 13, 2026
- 2 minute read
This topic covers how to install a flow runtime using Docker-compose.
Prerequisites
You have a platform that supports the minimum requirements:
-
Docker is installed
-
Docker Compose is installed
-
Install a flow runtime using Docker-compose
-
Sign on to the Connect flows registry site: https://registry.flows.connect.aveva.com/
-
Open a terminal and enter: [sudo] docker login https://registry.flows.connect.aveva.com/
-
When prompted, enter the user name and password.
-
To locate the user name and password, open Flow manager, then select Manage and then select Flow runtimes.
-
Select the Settings icon. The Flow runtime artifacts dialog opens.
-
Select the Docker installation tab.
-
-
Scroll down in the dialog and locate the user name and password under step 1.
-
Copy this information to the clipboard.
-
From the flow runtime page, select the Register flow runtime tab.
-
-
Create docker-compose.yml
Download the file: Docker yaml code samples.
-
Before running this Docker Compose file, create a secret for encrypting persisted credentials with the commands below.

-
Download the file into a local folder or create it using the code sample below.

-
Configure credentials
-
Option A: Id and AccessKey
Replace <ID> and <KEY> with the values from Show Credentials.
-
Option B: Global key
For mass deployment, generate a registration key in the Key and Name Pattern tab, then replace the credential lines with the following:
- SecurityConfiguration__Registration__Key=ENTER-YOUR-GLOBAL-KEY-HERE
- SecurityConfiguration__Registration__Name=UNIQUE-NAME-HERE # Optional
Then replace:
ENTER-YOUR-GLOBAL-KEY-HERE with the registration key from the Key and Name Pattern tab.
UNIQUE-NAME-HERE (optional) with a unique runtime name using only alphanumeric characters and underscores.
-
Start the runtime
[sudo] docker compose up -d
The Runtime image will be downloaded from the registry and started.
-
Verify the runtime
If startup completes without errors, the runtime should appear in CONNECT Flows with a green checkmark on the Flow runtimes or Dashboard page.
Next, you can build and deploy flows on the new runtime.