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.