---
title: "Install in an online Bring-Your-Own (BYO) cluster with KOTS"
description: ""
url: "https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.16.0/install/install-via-kots-online/index.html"
---
This procedure is for a client-managed cluster (Bring-Your-Own cluster). For all deployments, see [Deployment options](https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.16.0/install/deployment-options/index.html#client-managed-cluster).

## Prerequisites


**Important**


ITRS Analytics versions prior to 2.15.4 will fail to deploy on online installations due to `bitnami/kubectl` image deprecation. Air-gapped deployments are unaffected. To prevent deployment failures, you must upgrade to version 2.15.4 or later. This release includes updates that replace `bitnami/kubectl` with `chainguard/kubectl`. 

For more information, refer to this [documentation](https://docs.itrsgroup.com/docs/itrs-analytics/latest/faqs/bitnami-kubectl-image-migration/index.html).



Before installing ITRS Analytics, ensure that all the prerequisites are met in the environment where you will deploy.

-  Ensure your Kubernetes version is compatible with the ITRS Analytics Platform version you are installing. The supported managed service providers are listed below. 

    | **Cluster type**                                         | **Supported versions**      |
    |----------------------------------------------------------|-----------------------------|
    | Azure Kubernetes Service (AKS)                           | 1.29, 1.30, 1.31, 1.32      |
    | Amazon Elastic Kubernetes Service (EKS)                  | 1.29, 1.30, 1.31, 1.32      |
    | Google Kubernetes Engine (GKE)                           | 1.30, 1.31, 1.32            |
    | Oracle Cloud Infrastructure Kubernetes Engine (OKE - Beta) | 1.31, 1.32                |
    | RedHat OpenShift Container Platform (OCP)                | 4.16, 4.17, 4.18, 4.19      |

    For compatibility details with earlier versions, please refer to the [compatibility matrix](https://docs.itrsgroup.com/docs/all/itrs-analytics/compat-matrix/index.html).

-  Check that [resource and hardware requirements](https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.16.0/prerequisites/resource-hw-requirements/index.html) are met.

-  Note the host name of the server, which will be used for accessing ITRS Analytics from outside the Kubernetes cluster. 

-  Make sure that a load balancer is configured for your cluster.

-  Ensure cluster permissions are set. By default, KOTS uses [cluster-scoped RBAC](https://docs.replicated.com/enterprise/installing-general-requirements#cluster-scoped), which is used in BYO online environments. Alternatively, you can choose to grant [namespace-scoped RBAC permissions to KOTS](https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.16.0/prerequisites/minimal-rbac/index.html).

-  For Medium and Large-sized deployments, you must assign the appropriate labels and taints to nodes designated for timescale to ensure proper scheduling and workload isolation.
  
  -  For `label` command:
    ```
    kubectl label nodes <node_name> instancegroup=timescale-nodes;
    ```

  -  For `taint` command:
    ```
    kubectl taint nodes <node_name> dedicated=timescale-nodes:NoSchedule;
    ```

## Start installation

If you opt to install ITRS Analytics in an existing cluster, you should choose the **Bring-Your-Own (BYO)** option. You can either download `kotscli` from the Customer's Download Portal or continue with the next installation steps.

Installing ITRS Analytics via Kubernetes Off-the-Shelf (KOTS) streamlines the process through the use of a `kubectl` plugin (KOTS CLI) and an admin console where you can upload your license file, choose install options, and
run pre-flight checks prior to deployment.

To install ITRS Analytics using KOTS, do the following:

-  Install the latest KOTS CLI, which is a `kubectl` plugin. Run: 
  
  ```
  curl https://kots.io/install | bash
  ```

-  Install the admin console on your desired namespace. To do this, run:

    ```
    kubectl kots install itrs-analytics/stable -n [namespace] 
    ```

## Log in to the Admin Console

-  Once the namespace has been created, you'll see a link to the admin console in the command line. Using the password you set in the previous step, log in to the admin console.

-  When prompted, upload your license file in the admin console.  

  - The license file should have been previously provided to you. Contact your ITRS representative if you do not have the required information.

-  Click **Download ITRS Analytics from the Internet**.


**Tip**


For a visual walkthrough of the installation process, please watch the demo. If you prefer, you can follow the detailed instructions below.



https://app.storylane.io/demo/9s6mpqkr4ap2

## Configure ITRS Analytics

### Prerequisites

-  On the **Configure ITRS Analytics** screen, set your options and then click **Continue**.

-  On the **Prerequisites** section, verify that the required packages have been installed.

### Cluster Settings

-  On the **Cluster Settings** section, select the appropriate cluster size based on your needs. For more information, see [Sizing guidelines](https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.16.0/prerequisites/resource-hw-requirements/index.html).

### Host names

-  On the **Host names** section, specify the paths to the apps and ingestion host names you will use.

  
**Note**


Starting in ITRS Analytics version 2.12.0+2, you are required to enter a fully qualified domain name (FQDN) for both the **Apps external host name** and **Ingestion external host name** where the application will be accessible.



### ITRS Analytics Apps

-  Navigate to the **ITRS Analytics Apps** section, where you’ll find all required and optional production apps, as well as beta apps. From this list, select the apps you want to install.

  
**Note**


Starting with ITRS Analytics version 2.12.0+6, the option to select between production and beta apps or only production apps during setup up has been removed. For more details, see [Changes to App Installation Type selection](https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.16.0/upgrade/itrs-analytics-upgrade-notes/index.html#changes-to-app-installation-type-selection).



   The following apps are listed as **Required Apps** in the KOTS Admin Console.

  | Required apps | Description |
  |---|---|
  | Web Console | [ITRS Analytics Web Console](https://docs.itrsgroup.com/docs/itrs-analytics/app/webconsole/current/user-guide/prerequisites/index.html) lets you easily track critical monitoring data of your always-on enterprise from a web browser. |
  | Query Service | [ITRS Analytics Query Service app](https://docs.itrsgroup.com/docs/itrs-analytics/app/query-service/current/user-guide/app-query-service/index.html) provides a materialized view of the objects for entities stored in the ITRS Analytics Platform. It also exposes additional query capabilities that are not directly supported by the ITRS Analytics Platform.
  | Entity Viewer | [ITRS Analytics Entity Viewer app](https://docs.itrsgroup.com/docs/itrs-analytics/app/entities/current/user-guide/about/index.html) provides a web-based interface for real-time monitoring, investigation, and analysis of entities tracked in ITRS Analytics.
  | Commands | [ITRS Analytics Commands app](https://docs.itrsgroup.com/docs/itrs-analytics/app/commands/current/user-guide/commands/index.html) enables additional command functions in the Entity Viewer app.
  | Public API | [ITRS Analytics Public API](https://docs.itrsgroup.com/docs/itrs-analytics/app/api-gateway/current/user-guide/api-gateway/index.html) provides a publicly accessible REST API to interact with the ITRS Analytics Platform. |

   The **Optional Apps** section includes recommended apps, as well as other apps you can install depending on your business requirements.  

   **Beta apps** are pre-release versions that are still in development and testing. They may offer new features that are not yet fully validated, which can introduce operational risks. Use beta apps only in non-production environments to avoid impacting business operations.

### Credentials

-  The **Credentials** section contains default login information for different user and admin levels, intended for informational purposes.

### Storage Settings

-  On the **Storage Settings** section, click a checkbox to display configuration options. Note that modifying these settings may require advanced configuration to adjust correctly.  When configuring storage classes, make sure that upgrades are supported, since these are performed independently from ITRS Analytics installation.

### Advanced Settings

-  On the **Advanced settings** section, select **Show Advanced Configuration** to view advanced configuration options.
  
-  Under **Uptrends Configuration**, you can toggle **Enable RUM** to activate the Uptrends Real User Monitoring (RUM) integration for ITRS Analytics. 

  
**Note**


You can integrate Uptrends’ Real User Monitoring (RUM) with ITRS Analytics to gain detailed insights into how users interact with the platform in real-world conditions. You can monitor key pages and apps, such as Entity Viewer and Dynamic Thresholds, to better understand user experience, performance, and potential issues.

To get started with Uptrends RUM, follow the [Uptrends documentation](https://www.uptrends.com/support/kb/rum/setup), and use this [guide](https://www.uptrends.com/support/kb/rum/understanding-real-user-monitoring#what-does-a-rum-script-look-like) to find the Site ID (SID).



  Enabling this option displays the **RUM SID** field, where you must enter the SID or Site ID to complete the monitoring setup.

  ![Deploy failed](https://docscdn.itrsgroup.com/itrs-analytics-platform/images/iax-install-advanced-enable-rum.png)

-  Under **Service Mesh**, select to install `trust-manager` for Linkerd integration (only available if `linkerd` installation is enabled).

-  Under **TLS Certificates**, you can choose between using self-signed certificates or deploying your own custom, non-self-signed certificates.
  - If you keep the default self-signed option, ITRS Analytics manages the certificates for you.
  - To use non-self-signed TLS certificates for ITRS Analytics endpoints, select **ITRS Analytics: custom certificates**. This displays the ITRS Analytics certificate and key fields where you can upload a PEM certificate file and the corresponding private TLS key.
  - If `linkerd` is enabled and you want to use custom certificates for the service mesh, select **Linkerd: custom linkerd certificates**. You must provide a PEM file and a corresponding private TLS key for the Linkerd certificates.

-  Under **Ingress Annotations**, you must specify custom annotations for ingress resources when using an alternative ingress controller. An ingress controller is mandatory for all deployments. Configuring annotations does not eliminate this requirement. 

- When to configure ingress annotations:
  - If you are using the default bundled `ingress-nginx` controller, no custom annotations are typically required.
  - Custom annotations are needed when you install and use a different ingress controller (such as HAProxy, AWS ALB, or a manually configured `ingress-nginx` with specific requirements).
  - Annotations configure how your chosen ingress controller handles traffic routing and cannot be used to bypass the requirement for an ingress controller.
  
- Example scenarios requiring custom annotations:
  - Using an internal Layer 7 load balancer with `ingress-nginx` configured as ClusterIP service with network endpoint groups (NEGs).
  - Integrating with cloud-specific load balancers (for example, AWS ALB, and GCP L7 LB).
  - Custom `ingress-nginx` installations with non-standard configurations.

-  Under **Preflight and Support Bundle Settings**, select to enable **Run Disk I/O Performance Test** or **Include Disk I/O Test for Support Bundle**.

-  Under **Backup and Restore**, select **Enable IAX backup and restore** to activate backup and restore support for ITRS Analytics using Velero.

-  Under **Timescale Workload Scheduling**, enable **Enforce Timescale Node Selector** to ensure Timescale workloads run only on nodes matching the defined selector. This option is enabled by default, and disabling it may result in performance or stability issues.

-  Under **Helm Install/Upgrade Options**, you can configure the **ITRS Analytics Helm Chart Timeout** setting to be used during installation or [upgrade operations](https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.16.0/upgrade/itrs-analytics-upgrade-notes/index.html#helm-chart-timeout-adjustment-required). 

-  In the **Helm Chart Values Override** (formerly *Parameters Override*), input your desired configuration values to override the default Helm chart settings and then save your configuration.
    
### Preflight checks and deploy

-  Once you have verified that your environment has met the prerequisites during the preflight checks, click **Deploy**. Once the status of all resources are confirmed ready, the install is completed.


