Self-hosted setup using GCP VM instance
This guide walks you through deploying ThingsBoard Professional Edition on a GCP VM instance.
For a pre-configured image-based deployment, see GCP Marketplace.
Prerequisites
Section titled “Prerequisites”You need admin access to Compute Engine in your GCP account.
Step 1. Create VM instance
Section titled “Step 1. Create VM instance”Create a VM instance using the GCP documentation. Choose Ubuntu Server 24.04 LTS as the operating system.
Step 2. Configure firewall rules
Section titled “Step 2. Configure firewall rules”Open the following ports in the firewall rules for your instance:
| Port | Protocol | Description |
|---|---|---|
| 22 | TCP | SSH access |
| 80 | TCP | HTTP access |
| 443 | TCP | HTTPS access |
| 1883 | TCP | MQTT protocol |
| 8883 | TCP | MQTT over SSL |
| 7070 | TCP | Edge RPC service |
| 9090 | TCP | Remote Integration service |
| 5683–5688 | UDP | CoAP and LwM2M protocols |
Step 3. Install ThingsBoard
Section titled “Step 3. Install ThingsBoard”Connect to your instance via SSH and follow the Docker installation guide to install and configure ThingsBoard PE.