Quickstart
This section helps you to quickly install Edge on a Lightweight Kubernetes (K3s) cluster with default options. For detailed instructions, see Installing Edge on Kubernetes.
-
Verify that your hardware meets the requirements specified in Prerequisites.
-
Run the command below to install K3s.
USER_NAME=$(whoami) USER_HOME=$(eval echo ~${USER_NAME}) sudo sh -c ' 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=v1.25.13+k3s1 sh -s - \ --write-kubeconfig-mode 644 \ --disable=traefik \ --protect-kernel-defaults true \ --kube-apiserver-arg=admission-control=ValidatingAdmissionWebhook,MutatingAdmissionWebhook && \ 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" && \ k3s crictl pull rancher/klipper-lb:v0.4.4 && \ k3s crictl pull rancher/mirrored-metrics-server:v0.6.3 && \ k3s crictl pull rancher/local-path-provisioner:v0.0.24 '
-
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/2024/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 1018.0.1 named c8yedge with the domain myown.iot.com.
kubectl apply -f https://cumulocity.com/docs/2024/files/edge-k8s/c8yedge-sample.yaml
-
See Verifying the Edge installation and Accessing Edge to sign into Edge.