This section describes how to set up the nextgen gateway on Ubuntu VM.


To deploy a NextGen cluster in your kubernetes environment, make sure your environment meets these requirements:

  • Helm 3.8.2 or higher
  • Kubernetes (K3S or K8S) - 1.20.x - 1.17.x or higher
  • 8 GB Memory
  • 50 GB Disk
  • 4 Core of CPU
  • Ubuntu 20.04 OS
  • AMD64/ARM64 Arch
  • Configure the default storage class and CSI plugin in the Kubernetes cluster.
    • When deploying in AWS EKS and using the EFS-based storage class, ensure that both UID and GID are set to 70.
  • If you have a multi-node Kubernetes cluster, use an external load balancer service like MetalLB to support multi-node cluster.
  • Download the OpsRamp Collector Bootstrap Tool.
    Refer to the article on how to download the OpsRamp Collector Bootstrap Tool.

Installation of k3s

To install the k3s the follow the below steps:

  1. Installing k3s with following command:

    • To install latest version of k3s use the following command.
      sudo curl -sfL | INSTALL_K3S_EXEC="--cluster-init --disable traefik" sh -
    • To install a particular version of k3s use the following command (only replace the version with the required version below the command).
      curl -sfL | INSTALL_K3S_EXEC="--cluster-init --disable traefik" INSTALL_K3S_VERSION="v1.23.5+k3s1" sh -
  2. Add following lines to /etc/environment.


  3. Run following command or re-login to shell to access the kubernetes.

    export KUBECONFIG=/etc/rancher/k3s/k3s.yaml

Installation of helm

To install the helm the follow the below steps:

  1. Download helm binary with following command
    sudo wget
  2. Change helm permissions to 755.
    sudo chmod 755 helm
  3. Move the helm binary to /usr/local/bin/ folder.
    sudo mv helm /usr/local/bin/

Download the OpsRamp Collector Start Binary

  1. Download opsramp-collector-start binary from downloadable links provided by opsramp team.
    sudo wget
  2. Change opsramp-collector-start permissions to 755.
    sudo chmod 755 opsramp-collector-start
  3. Move opsramp-collector-start binary to /usr/local/bin/ folder
    sudo mv opsramp-collector-start /usr/local/bin/

Advanced configuration

For advanced configuration and instructions, refer Collector Bootstrap Tool documentation.