The following prerequisites are required for a clustered deployment:



Kubernetes Cluster

  • A fully working Kubernetes cluster

  • User credentials with privileges for

    • creating namespaces

    • and full acces the the created namespaces

Ingress Controller

The Ingress Controller must have

  • a publicly reachable IP address

  • which is not blocked by a firewall on ports 80 and 443

The nginx-ingress-controller is recommended, though not strictly required.

DNS Name

The thingsHub requires for name resolution:

  • A DNS entry for the selected domain name (

  • A DNS entry for all of the domains subdomains (*

TLS Certificate

This includes

  • Valid TLS certificates for the selected domain name and and the subdomains

  • The private key for these certificates

Alternatively, TLS can be handled in a customer-provided load balancer

The following prerequisites are recommended for a clustered deployment



Whitelabeling information

For whitelabeling:

  • The company or platform name

  • A url-compatible variation thereof (all lowercase, numbers and dashes, no leading number or dash, no two consecutive dashes, no dash at the end)

  • A small logo image file to be display in the UI's navigation bar

SMTP Server

An SMTP server and user credentials to use this server for sending alerting and notification emails

Database Servers

Depending on company policy, use of external database systems is recommended:

  • PostgreSQL 9.6

  • InfluxDB 1.7