Create an EMQX Agents Deployment

Use this page to create an EMQX Agents deployment in the EMQX Cloud Console.

Prerequisites

Before creating an EMQX Agents deployment, make sure you have at least one of the following in the target region:

• A running EMQX Broker deployment
• A running EMQX Tables deployment

If no such deployment exists in your chosen region, create one first. See Create a Dedicated Flex Deployment or Create an EMQX Tables Deployment.

Where to Start

You can start creating a deployment from two places:

• On the project Home page, click + New on the EMQX Agents card.
• On the New Deployment page, select the EMQX Agents plan.

Step 1: Choose a Plan

The Starter plan is the only available option during the Public Beta period. It is selected by default.

The Starter plan includes:

• MQTT & Time-Series Data
• AI-Powered Analysis
• Real-Time Event Monitoring
• Automated Actions

Step 2: Select Cloud Provider and Region

Choose the Cloud Provider and Region where the deployment will run.

Supported cloud providers are AWS and Google Cloud. Select the same provider and region as your existing EMQX Broker or EMQX Tables deployment to enable network association in the next step.

Step 3: Configure Network Association

Under Network Association, select an existing network from the dropdown. This associates the EMQX Agents deployment with the same VPC as your EMQX Broker or EMQX Tables deployment, enabling private connectivity and lower latency.

Important Notice

If no network is available in the selected region, the following message appears:

No network is available for EMQX Agents in this region. Create an EMQX Broker or an EMQX Tables first.

Select a different region or create an EMQX Broker or EMQX Tables deployment in the same region before proceeding.

Step 4: Set a Deployment Name (Optional)

Enter a name for the deployment. If left blank, a name is automatically generated, for example deployment-b8f11c8b.

The deployment name can be changed after creation from the Deployment Settings page.

Step 5: Review and Deploy

The Summary panel on the right shows the selected plan, cloud provider, region, and associated network. Settings marked with an asterisk (*) cannot be changed after the deployment is created.

Click Deploy. A Tips dialog appears asking you to confirm. Click Confirm to start provisioning.

The deployment takes a moment to initialize. Once it is ready, it appears in your project's Deployments list with a Running status.

Next Steps

• Add a Connector to connect the deployment to your EMQX Broker or EMQX Tables.
• Start a Chat to build your first agent.
• Manage Your Deployment