Create an EMQX Tables Deployment
This guide walks you through the process of creating an EMQX Tables deployment, a fully managed time-series database powered by GreptimeDB. You can use EMQX Tables to store, query, and analyze your MQTT data within the EMQX Cloud.
Where to Start
You can create an EMQX Tables deployment from two locations in the EMQX Console:
- On the Overview page, under the EMQX Tables section, click + New Deployment.
- Within a Project, go to the Explore EMQX Tables section and click + New Deployment.
Step 1: Choose a Plan
On the New Deployment page, choose from the available plans for your EMQX Tables deployment:
- Starter Plan: Suitable for small-scale or trial deployments. Supports single-AZ, limited resource tiers, public/internal endpoints, and select regions on AWS, Azure, and Google Cloud.
- Pro Plan: Designed for production workloads that require higher availability and performance. Supports multi-AZ high availability, larger resource capacity, 24/7 expert support, and 99.9% SLA.
For a detailed comparison, see EMQX Tables Product Plans.
Note
Creating a Pro deployment requires a paid account with access to Tables Pro. Free trials are not supported.
Step 2: Select Cloud Provider and Region
Choose your preferred Cloud Provider & Region for deployment.
AWS, Azure, and Google Cloud are supported for Starter deployments. For a Pro deployment, select one of the following provider and region combinations:
- AWS and US East (Ohio) (
us-east-2) - Google Cloud and Iowa (
us-central1)
For the full list of available regions, see Cloud Providers and Regions.
Choosing the right region can help reduce latency for your devices and may be important for compliance with data residency requirements.
Step 3: Network Association (Optional)
If a compatible EMQX Broker, EMQX Fleets, or EMQX Agents network exists in the same cloud platform and region, you can associate the Tables deployment with that network. Select the network from the Network Association dropdown to deploy the services in the same VPC and enable private connectivity. For more details, see Project-Level Network Management.
A network can contain only one deployment of each service type: EMQX Broker, EMQX Tables, EMQX Fleets, or EMQX Agents.
If you leave this field blank, the Tables deployment will be created with its own separate network. You can view all project networks from the Network Management section in the project's left menu.
Step 4: Select Tier
Choose the Tier (resource configuration) for your deployment. The tier determines the available compute, memory, storage, and monthly egress traffic.
Available self-service options for the Starter plan include:
| Tier | Storage | Egress Traffic/month | Use Case |
|---|---|---|---|
| 2 vCPU / 8 GB | 100 GB | 100 GB | Development / Testing |
| 4 vCPU / 16 GB | 200 GB | 200 GB | Small-scale workloads |
| 8 vCPU / 32 GB | 500 GB | 500 GB | Medium-scale workloads |
| 16 vCPU / 64 GB | 1 TB | 1 TB | Higher ingest rate workloads |
Available self-service options for the Pro plan include:
| Tier | Storage | Egress Traffic/month | Use Case |
|---|---|---|---|
| 2 vCPU / 8 GB | 100 GB | 100 GB | Small production workloads |
| 4 vCPU / 16 GB | 200 GB | 200 GB | Production workloads with higher query or ingest needs |
| 8 vCPU / 32 GB | 500 GB | 500 GB | Medium-scale high-availability workloads |
| 16 vCPU / 64 GB | 1 TB | 1 TB | Higher ingest rate high-availability workloads |
Additional usage pricing:
- Storage over quota: $0.04 / GB-month (compressed)
- Egress traffic over quota: $0.09 / GB for Starter and $0.15 / GB for Pro
If you need more capacity, contact support for custom sizing options.
Step 5: Set a Deployment Name (Optional)
Enter a name for the deployment. If left blank, a name is automatically generated.
Step 6: Review and Deploy
The Summary panel on the right shows your current configuration, including the selected plan, region, tier, and the project under which the deployment will be created.
The project defaults to the last project you accessed. You can switch to a different project at any time before deploying by clicking the project name at the top of the page.
Note
The project cannot be changed after the deployment is created.
Once you have reviewed the configuration, click Deploy. The provisioning process may take a few minutes.
Note
Settings marked with an asterisk (*) cannot be changed after launch. Review the project, plan, provider, region, network association, and tier before deploying.
View Deployment Information
Once the deployment is ready, you can:
- View deployment status.
- View Connection Info, including public host, internal host, default database name, and network ports.
- Monitor resource usage, including CPU, memory, storage, and egress traffic.
- Use the built-in Quick Start section to:
- Integrate with an EMQX Broker
- Connect with client tools
- Visualize data using third-party tools like Grafana
The screenshot above shows a Starter deployment. The Connection Info section provides a Ports Management button to enable or disable ports individually. For details, see Ports Management. For Pro deployments, use the ports shown in Connection Info.