EMQX Cloud

English

简体中文
日本語

English

简体中文
日本語

Appearance

Contact Us
Contact Us

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, review these requirements:

  • You must have an EMQX Cloud account with an active project.
  • You need the root account, the Administrator role, or the Project Administrator role for that project to create the subscription and deployment.
  • Creating a new EMQX Agents deployment requires a Starter subscription. For eligible accounts, the free trial is the first period of that subscription.
  • To create the subscription directly in the Console, you must link a credit card, including when the subscription starts with a free trial. A Project Administrator cannot link a card; ask the root user, an Administrator, or an Accountant to do so before creating the deployment. For complete role permissions, see Role Permissions Matrix.

Review Before You Subscribe for payment eligibility and Free Trial for trial and renewal terms.

An EMQX Broker or EMQX Tables deployment is not required. You can create the Agents deployment first and add the other services later.

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 plan and is selected by default. For its subscription price and Included Credits, see Plan and Billing.

The Starter plan includes:

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

Step 2: Select a Region ​

Google Cloud is the only supported cloud provider. Select the Region where the deployment will run.

Step 3: Configure Network Association (Optional) ​

The Network Association (Optional) section appears when a compatible EMQX Broker, EMQX Tables, or EMQX Fleets network is available on Google Cloud in the selected region.

  • If you select a network, EMQX Cloud deploys Agents in the same virtual private cloud (VPC) as the associated service. Services in the same network can communicate through private addresses by default.
  • If you do not select a network, or if the section does not appear, EMQX Cloud creates a separate network for Agents. Services in different networks must communicate through public addresses. For example, to access Tables in another network, use the Tables public connection address and port 443, not the default port 4000.

You can also create Agents first. When you later add other compatible services, select the Agents network to place them in the same VPC.

Important Notice

You cannot change the network of a deployment after the deployment is created. Confirm the network selection before you deploy.

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: Subscribe and Deploy ​

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

Subscribe Directly in the Console ​

If Subscribe & Deploy is displayed, complete the following steps:

  1. Review the deployment configuration, subscription price, amount due, trial eligibility, and next billing date in Summary.
  2. Under Payment Method, verify the linked card. If the section is collapsed, click View Payment Method. If the Console prompts you to add a credit card, complete card setup, and then review the summary again. Linking a card does not start the subscription.
  3. Click Subscribe & Deploy and complete any terms confirmation or card issuer authentication requested by the Console. The deployment is created only after the trial subscription is confirmed or the initial payment succeeds.
  4. Wait for the deployment card to appear and reach Running, then click the card to open the deployment.
  5. Click Deployment Settings. Under Billing Method, verify that Subscription Status is Free trial or Subscribed, and check Next Billing Date.

Contact Support ​

If Contact Us is displayed instead of Subscribe & Deploy, use it to open a support ticket with the deployment configuration. Accounts using a US bank account or marketplace billing follow this route.

Continue an Interrupted Creation ​

If the Console offers Retry Verification, Retry Confirmation, or Retry Deployment, use the displayed action to continue the same subscription attempt. These retry actions are available on the creation page where you started the subscription. Refreshing or leaving the page does not restore an interrupted attempt.

If you cannot continue the creation process using the available retry action, submit a support ticket for assistance.

Next Steps ​