Skip to main content

IOMETE deployment on GCP

Installing the IOMETE platform is a quick and easy process that won't take up much of your time

Getting started with IOMETE is simple and can be done with just a few clicks. However, if you're new to using GCP, you'll need to install some tools on your local computer before you can begin. To get started, make sure you have a GCP account.


To install new resources you have to provide a project id. It's possible to use the existing project but, we recommend to create a new project to isolate access and resources. See:

Required tools

Make sure you have the following tools installed on your local computer:

Signup for IOMETE

Create an organization

Register for an account on the IOMETE Console and create an organization.

IOMETE Organizations
IOMETE Organization create

Create a New Cluster

Select the provider and select the region where the cluster will be installed.

Cluster Setup

Define a workspace name

Workspaces are isolated spaces that can be used by different departments, divisions, and so.

Workspace define

Terraform configuration

The system will generate a terraform script including unique cluster_id.

Terraform configuration

Don’t change cluster_id, this ID will be used to access your cluster (ex. connect external BI tools).

Deploy IOMETE to GCP

Download the terraform script file provided in the IOMETE console and execute it.


The use who will run the terraform script needs to have the following permissions:

  • GCP Project Admin

1. Navigate to the folder in CLI.

Navigate to the folder where you downloaded the terraform script file in your terminal.

2. Authenticate to GCP

gcloud auth login
gcloud auth application-default login

Make sure you have selected the correct project.

3. Apply the terraform script

# Initialize Terraform
terraform init

# Create a plan
terraform plan

# Apply the changes to your GCP
terraform apply

Once the terraform apply the command has finished, you should see a new file called IOMETE_DATA in the same folder where you ran the terraform script. This file contains the information you need to register your cluster with IOMETE. Open the IOMETE control plane interface. Find the appropriate section or field to register your cluster. Paste the copied information from the IOMETE_DATA file into the respective fields in the IOMETE control plane. Follow any additional instructions or steps in the IOMETE control plane to complete the registration process.


Here are the fields you need to copy from the IOMETE_DATA file:

  • GKE Name
  • GKE Endpoint
  • Cluster CA Certificate
  • Cluster Service Account Key
Terraform output to IOMETE Console to Complete the installation

Once you hit the Execute button, IOMETE will start the installing IOMETE operator inside the Kubernetes cluster. This will take a few minutes.

That's it! You've successfully set up IOMETE using Terraform. If you encounter any issues or have any questions, please don't hesitate to contact our support team at:


It's important to store your Terraform state file in a secure location to avoid losing it. If you lose the state file, you won't be able to manage the cluster with Terraform anymore. You can store the state file in a git repository, S3 bucket, or local folder. For more information on Terraform backends, please refer the FAQ below about saving terraform state in an external location.

Additional Resources

Start using IOMETE with the following guides