Skip to main content
Version: Next 🚧

Installing Epinio on a local K3s

This How-to was written with these versions:

Install a K3s cluster

Follow the K3s instructions to install K3s.

Install Epinio on the K3s cluster

Export the K3s cluster configuration file in the KUBECONFIG environment variable:

export KUBECONFIG=/etc/rancher/k3s/k3s.yaml

Follow the wildcard DNS setup to install DNS for Epinio in your environment.

You find the <IP> address with the next command. Example output is shown:

$ kubectl get svc -n kube-system traefik -o jsonpath="{.status.loadBalancer.ingress[0]}" | jq .
"ip": ""

Then, continue with the Epinio installation process.


DNS Issues

If you experience issues with DNS resolution, if, for example, you have something like this in your logs:

dial tcp: lookup on no such host

You can try to install K3s with this known-to-work DNS server:

curl -sfL | K3S_RESOLV_CONF=/etc/my-good-resolv.conf sh -

With /etc/my-good-resolv.conf containing:


This issue may happen with multiple DNS servers and some can't resolve some domain names.


In case of trouble with Epinio's Traefik component refer to the Traefik section in the Advanced Topics document.