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.

  1. Verify that your hardware meets the requirements specified in Prerequisites.

  2. Run the command below to install K3s.

    sudo bash -c 'echo -e "vm.panic_on_oom=0\nvm.overcommit_memory=1\nkernel.panic=10\nkernel.panic_on_oops=1" >> /etc/sysctl.d/90-kubelet.conf' \
&& sudo sysctl -p /etc/sysctl.d/90-kubelet.conf \
&& curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=v1.25.13+k3s1 sh -s - --disable=traefik --write-kubeconfig-mode 644 --protect-kernel-defaults true  --kube-apiserver-arg=admission-control=ValidatingAdmissionWebhook,MutatingAdmissionWebhook \
&& mkdir -p ~/.kube \
&& sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config \
&& sudo chown $USER:$USER ~/.kube/config \
&& sudo chmod 600 ~/.kube/config \
&&echo -e '\e[32mSuccessfully installed k3s!\e[0m'

  3. Run the command below to install Helm v3.

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

  4. Run the command below to install the Edge Operator and provide the repository credentials when prompted.

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

  5. Run the command below to apply Edge CR (c8yedge-sample.yaml) for installing Edge version 1017.0.0 named c8yedge with the domain myown.iot.com.

    kubectl apply -f https://cumulocity.com/guides/10.17.0/files/edge-k8s/c8yedge-sample.yaml

  6. See Verifying the Edge installation and Accessing Edge to sign into Edge.