Skip to main content
Version: Next 🚧

Installing Epinio on a local K3d

This How-to uses these versions:

Install a K3d Kubernetes cluster​

Follow the K3d instructions to install K3d on your system.

Create a K3d Kubernetes cluster​

$ k3d cluster create epinio

Create a K3d Kubernetes cluster inside a VM​

Epinio needs to connect to pods inside the cluster. The default installation uses the internal docker IP for this. If docker is running in a VM, for example, with Docker Desktop, that IP won't be reachable.

As a workaround, use the IP of the host instead, together with port-forwardings:

k3d cluster create epinio -p '80:80@loadbalancer' -p '443:443@loadbalancer'

After this, kubectl should be talking to your new cluster:

$ kubectl get nodes
NAME                  STATUS   ROLES                  AGE   VERSION
k3d-epinio-server-0   Ready    control-plane,master   38s   v1.22.6+k3s1

Install Epinio on the cluster​

Follow wildcard DNS setup to define the domain name you want to use for Epinio.

Then, continue with the Epinio installation process.

Troubleshooting​

Kubeconfig​

To get kubeconfig to access the cluster:

k3d kubeconfig get epinio

Traefik​

In case of issues with Epinio's Traefik component or Ingress controllers, refer to the Traefik section in the Advanced Topics document.