Skip to content

CDC agent installation

The Matillion CDC Agent is provided as a container image. This image is required to be deployed and configured within your organization's private cloud and/or on-premises technology stack, and will require access to the source database, the target cloud data lake, and secrets management application of either AWS Secrets Manager, Azure Key Vault, or Google Secret Manager.

Agent installation process

We recommend using the following quick guides to add a CDC agent in Data Loader, and deploy that agent in your chosen cloud platform:


Your source database will also require configuration to work with CDC. This is independent from the agent installation process. More information can be found in the CDC Sources category. Your choice of agent installation does not limit the available data sources.

Manual installations

Manual installations are complex and are documented for advanced users. We have supporting articles, such as the Cloud Resources sections, and individual template articles for each of the cloud providers. However, we highly recommend following the quick guides for CDC agent creation and deployment. The quick guides document how to create and configure almost every cloud resource on your behalf, and is by far the best way to install the Matillion CDC agent. For more information, read:

The Agent

  • The Matillion CDC agent can run only one CDC pipeline. Each CDC pipeline requires a new agent installation.
  • An agent entry must be added in Data Loader, first. Then the agent itself must be installed on your cloud platform.
  • CDC supports multiple schema and you can select any schemas and tables that you wish to include in the CDC pipeline.


Container images can't be accessed directly via a browser. To pull a container image from the public repository specified, please reference the AWS documentation. The agent container image is available at the following public repository:


The agent requires direct access to the Matillion CDC servers for control and management. To enable this route, the agent will require outbound access to the following public IP addresses:

EU region:

US region:

Technical Requirements

Matillion recommends providing the CDC Agent with 4 CPU Cores and 8 GB RAM. The agent is intended for use with x86 Linux systems.