Skip to content

Create an agent in your infrastructure

This topic explains how to create an agent in your own infrastructure. For a discussion of why you might want to deploy in your own infrastructure rather than use a Matillion Full SaaS solution, read Agent overview.


  • A Hub account. To register, read Registration.
  • Once you have signed up, log in to the Hub.

Create an agent

  1. Navigate to the Select your service page. Get there by clicking the Platform Navigation button (the 9-dot square in the top-left of the UI) and then by clicking Matillion start.
  2. Click the Manage Agents tile. Can't see it? Read Editing user permissions for agents.
  3. If you haven't created an agent yet, you'll land on Create your first agent. Click Create an agent.
Property Description
Agent name A unique name for your new agent. Maximum 30 characters. Accepts both uppercase and lowercase A-z, 0-9, whitespace (not the first character), hyphens and underscores.
Cloud provider This is a list of the currently supported cloud providers for the agent. As this support is increased, this list will follow suit.
Deployment The supported deployment method and/or type for the given cloud provider.
Agent version track This is the agent version track that will be deployed. The latest version in the selected track will be used every time your service is restarted. Read agent version tracks for details.

When you are happy with the agent configuration, click Create agent.

Set up the agent in your cloud infrastructure

When created with the above process, the agent needs to be set up in your cloud infrastructure. There are two methods for doing this, and you can use whichever methods suits you:

To complete these processes, you will require certain details of the created agent. To obtain these details, locate the agent in the list of agents, and click ... next to it, then click Agent details. The parameters and values in the sections Agent image URI, Agent environment variables, and Credentials are required when configuring your agent in your cloud infrastructure.