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 (Coming Soon): Designed for production scenarios, with multi-AZ support, private networking, and extended resource capacity.
For a detailed comparison, see EMQX Tables Product Plans.
Step 2: Select Cloud Provider and Region
Choose your preferred Cloud Provider & Region for deployment.
AWS, Azure, and Google Cloud are supported. 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 there is an existing EMQX Broker deployment 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 enable private connectivity between the Broker and Tables.
Each network can be shared by at most one EMQX Broker deployment and one EMQX Tables deployment at the same time.
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 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 |
Additional usage pricing:
- Storage over quota: $0.04/GB (compressed)
- Egress traffic over quota: $0.09/GB
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 the deployment will be created under.
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.
View Deployment Information
Once the deployment is ready, you can:
- View Connection Info, including public and internal host, database name, username, and password.
- 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
Manage Ports
Depending on your deployment, the Connection Info section may display port status for the supported protocols: gRPC (4001), MySQL (4002), PostgreSQL (4003), and gRPCS (5001). A Ports Management button will also be available.
Click Ports Management to open the port management dialog, where you can enable or disable each port individually.
| Column | Description |
|---|---|
| Protocol Security | The protocol associated with the port (gRPC, MySQL, PostgreSQL, or gRPCS). |
| Port | The port number assigned to the protocol. |
| Status | Whether the port is currently enabled or disabled. |
| Actions | Toggle switch to enable or disable the port. |