Quickstart

This section helps you to quickly install Edge on a Lightweight Kubernetes (K3s) cluster with default options. For detailed instructions, see Installing Edge.

Verify that your hardware meets the requirements specified in Prerequisites.
Make configuration changes to your operating system to work with K3s as per Requirements.

Run the command below to install K3s.

sudo sh -c '
   USER_NAME=$(whoami)
   USER_HOME=$(eval echo ~${USER_NAME})
   K3S_VERSION=v1.32.3+k3s1

   touch /etc/sysctl.d/90-kubelet.conf  && \
   sed -i "/^vm\.panic_on_oom=/d; /^vm\.overcommit_memory=/d; /^kernel\.panic=/d; /^kernel\.panic_on_oops=/d" /etc/sysctl.d/90-kubelet.conf && \
   printf "vm.panic_on_oom=0\nvm.overcommit_memory=1\nkernel.panic=10\nkernel.panic_on_oops=1\n" | tee -a /etc/sysctl.d/90-kubelet.conf && \

   sysctl -p /etc/sysctl.d/90-kubelet.conf && \

   curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=${K3S_VERSION} sh -s - \
      --write-kubeconfig-mode 644 \
      --disable=traefik \
      --protect-kernel-defaults true \

   mkdir -p '"$USER_HOME"'/.kube && \
   cp /etc/rancher/k3s/k3s.yaml '"$USER_HOME"'/.kube/config && \
   chown '"$USER_NAME:"' '"$USER_HOME"'/.kube/config && \
   chmod 600 '"$USER_HOME"'/.kube/config && \

   printf "\e[32mSuccessfully installed k3s!\e[0m\n"
'

Run the command below to install Helm v3.

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Run the command below to install the Edge operator and provide the registry credentials when prompted.

curl -sfL https://cumulocity.com/docs/2025/files/edge-k8s/c8yedge-operator-install.sh -O && bash ./c8yedge-operator-install.sh

Run the command below to apply Edge CR (c8yedge-sample.yaml) for installing Edge version 2025.0.2 named c8yedge with the domain myown.iot.com.
```
kubectl apply -f https://cumulocity.com/docs/2025/files/edge-k8s/c8yedge-sample.yaml
```
See Verifying the Edge installation and Accessing Edge to sign into Edge.