Deploying a remote harvesting server running a command - 8.0

Talend Data Catalog Installation and Upgrade Guide

Operating system
Talend Big Data Platform
Talend Data Fabric
Talend Data Management Platform
Talend Data Services Platform
Talend MDM Platform
Talend Real-Time Big Data Platform
Talend Data Catalog
Installation and Upgrade
Last publication date

Before you begin

  • You have been assigned a global role with the Application Administration capability.
  • You have installed and launched Docker Desktop on your machine. For more information, see
  • If necessary, you have configured Docker to use a proxy server. For more information, see

    Note that if you use a proxy server, you need to add an additional environment variable USESYSTEMSPROXIES=true when running the command.


  1. Open a command prompt or a terminal window.
    For Windows, use PowerShell.
  2. Execute the following command to run the container:
    docker run -d --restart unless-stopped
     --name <CONTAINER_NAME>
     -e CLOUD_URL=http://<server>:<port>/MM
    You can define the key parameters as follows:
    Parameter Action
    CONTAINER_NAME Enter the name of your remote harvesting server.

    Enter the URL of the Talend Data Catalog application server.

    AGENT_STRING Enter a shared secret set to anything as long it is:
    • unique,
    • reasonably descriptive so it can usefully be identified in the UI,
    • hard to guess since it also works as a shared secret string.
    DOCKER_IMAGE:TAG Enter talend/datacatalog-remote-harvesting-agent as the Docker image.

    Enter the version name of Talend Data Catalog build as the tag, such as 8-20211215.

    For example, you can enter talend/datacatalog-remote-harvesting-agent:8-20211215.

    You can find the list of Talend Data Catalog versions on

  3. Execute docker ps or go to Docker Desktop and check that the Docker container is running.


You are ready to add the remote harvesting server in Talend Data Catalog.