Linux Quick Start

Instructions for installing the Free Edition Edge Delta agent on Linux.

You can install the Edge Delta Free Edition agent on a local Kubernetes cluster hosted on your Linux system. This process involves setting up a new Kubernetes cluster, creating an Edge Delta account, and installing the Edge Delta agent in your new cluster. After installing the agent, you can Set Up Alerts.

Create a Kubernetes Cluster

In this example, you install Docker, Helm and kind. Then you create a local Kubernetes cluster.

Install Docker

  1. Set up the Docker repository:
sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
sudo mkdir -p /etc/apt/keyrings
curl -fsSL | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  1. Install the Docker Engine:
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli docker-compose-plugin

See more detailed instructions at the Docker site.

Install Helm

  1. Choose the appropriate release binary for your system architecture in the Helm github repo.
  2. Download the binary:
curl -O
  1. Unpack the binary file you downloaded:
tar -zxvf helm-v3.10.1-linux-amd64.tar.gz
  1. Locate the helm file and move it to /usr/local/bin/helm
sudo mv linux-amd64/helm /usr/local/bin/helm

Install Kind and Create a Cluster

  1. Install kind:
curl -Lo ./kind
chmod +x ./kind
sudo mv ./kind /usr/local/bin/kind

See more detailed instructions on the kind docs site.

You might need to find the appropriate release to suit your system architecture. See the list of kind releases on the kind releases github page.

  1. Create a Kubernetes cluster:
sudo kind create cluster

Create an Edge Delta Account

Next, create an Edge Delta user account.

  1. Click Login on the website.
  2. Click Sign up.
  3. Enter your details in the Account Details page and click Register. Alternatively, click Sign up with Google.
  4. Check your email and Activate your account.
  5. If a user with the same domain name as your email address has created an organization you can click it to request to join it and wait for their approval. Otherwise, click Create an Organization.
  6. Enter an Organization name and click Next.

Install the Edge Delta Agent

Install the Edge Delta agent daemonset in your Kubernetes cluster. This is done by first creating an agent configuration in the Edge Delta web app and then deploying the agent using the customized Helm commands that the web app provides.

After signing up in the web app, the initial set up page opens for deploying an Edge Delta Free Edition agent.

You can also create a new agent configuration manually. Click Admin - Clusters and click Add New Cluster.

  1. Enter a name for the agent tag - usually the same as the name of your cluster and click Continue.
2. Copy the three deploy commands from the web app as they include your agent's secret API key. Run them one at a time in your terminal (the K8s host's shell) to install the Edge Delta agent.
  • The first command downloads the Edge Delta Helm chart.

  • The second command updates all the charts in the local Helm repo.

  • The third command installs the correct version of the agent. It passes in the secret key to connect your agent to the Edge Delta web app, and it creates the edgedelta namespace for the daemonset. The following helm command option shows an example key 123456789 but yours will be specific to your agent.

--set secretApiKey.value=123456
  1. Click I Ran Deploy Commands. The web app checks for an agent hearbeat to confirm that the agent was successfully installed in your cluster and is able to send metrics to the web app.
  2. Click Go to Status Page.

After installing the agent, you can Set Up Alerts.