How to transfer a bot between pods

Symphony admins within your company have the ability to transfer a bot from one pod to another pod if for example, they have developed a bot in a test environment and then wish to move this bot to a live production environment.

To transfer a bot between pods:

  1. From the pod the user wishes to transfer the bot to, access the Admin Portal and navigate to Accounts > Create an Account.


  1. Select the Service Account tab.


  1. In the Basic Information fields, enter the same bot details and entitlements that were configured in the original pod. Note: Refer to the Knowledge Article found here on how to create a Service Account.
  2. Copy the contents of the public key file from the original pod and paste it into the text box under Authentication in the newly created bot Service Account.

Should there be a need to use a new RSA key pair, the user can replace them in the bot's project directory. For both the Python and Java BDK, the path to the keys are rsa/privatekey.pem and /rsa/publickey.pem

Note: The user will need to rename the new keys to match the old key names.

  1. Navigate to the bot's configuration file.


  1. Amend the relevant details to reflect the new pod.

Note: Some pods having on-premises components, network or architectural differences may require more details. The user may need to consult with their pod administrator or internal IT team for some of the information.

  1. Confirm if the transfer has been successful by attempting to run the bot in the new pod.

If you require further assistance with a bot transfer, please contact the Symphony Support team at