Install Kerno Locally
This section guides you through setting up Kerno on a local Kubernetes cluster
We're currently aware of issues with Docker on Apple M4 chips. If you're installing Kerno using Docker, please use a Mac with an earlier chip version (M1/M2/M3) for now. We're looking into a resolution and will provide updates soon.
Installing Kerno locally is a quick way to experience eBPF-powered observability in your Kubernetes cluster. In just a few steps, you’ll be collecting invaluable insights into your workloads and cluster behavior without complex configurations.
Local installations do not include the Kerno dashboard, but we’re actively working on it.
Prerequisites
A local Kubernetes cluster up and tunning
The kubectl CLI tool installed and configured to access your cluster.
Docker installed locally to run the installer image.
Minimum system requirements.
If you are using minikube please execute this command when creating the cluster:
minikube start --embed-certs
Installing Kerno
Ensure your kubectl
context is set to the cluster where you want to install Kerno:
Run the Kerno installer via Docker, mounting your local ~/.kube/config
:
The installation automatically creates the necessary deployments and daemon sets in your cluster.
Verifying the Installation
Kerno installs the following Kubernetes resources in the kerno
namespace:
Nanobe (Deployment)
Preon (DaemonSet)
Vector (DaemonSet)
You can learn more about Kerno's architecture here.
To verify that these resources are running correctly, run:
Ensure that all pods have a Running
or Completed
status. If any pods are in a CrashLoopBackOff
or Error
state, check their logs for more details.
After the installation is completed, the installer will output a unique Kerno key (K4_KEY
). This key identifies your local installation.
Important: For any subsequent operations (updates or uninstalls), you must provide the same K4_KEY
. Not using or using an incorrect key can result in unexpected behavior.
Exploring the Data
To inspect the data Kerno collects, replace <pod-name>
with the name of a running nanobe
pod:
Updating Kerno
To update Kerno with the latest release, rerun the installer command but include your K4_KEY
:
Uninstalling Kerno
If you need to remove Kerno and its components entirely from your cluster, set the UNINSTALL
environment variable to true
, along with your K4_KEY
:
Always confirm you are using the correct Kubernetes context before performing installation, updates, or uninstallation.
If you encounter issues or have questions, message us on Slack, and we’ll gladly help.
Last updated