# Kube-VIP

Kube-VIP is a self-contained virtual IP and load balancer for Kubernetes control plane and services, giving bare-metal, edge, and virtualised clusters lightweight high-availability access. It is open source and self-hosted, installable on Docker Hub and Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/6221/kube-vip

## Description

Kube-VIP is a self-contained virtual IP and load balancer for Kubernetes control plane and services, giving bare-metal, edge, and virtualised clusters lightweight high-availability access.

## Platform availability

Available on 1 of 10 platforms: Helm.

## Health score

75/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 2 days ago)
- Popular: 70 (3,008 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 69 (no serious findings, 3 minor, CI, tests, OpenSSF Scorecard 5/10)

## Links

- GitHub: https://github.com/kube-vip/kube-vip
- Docker Hub: https://hub.docker.com/r/cleanstart/kube-vip
- Kubernetes (Helm): https://artifacthub.io/packages/helm/kube-vip/kube-vip
- Official website: https://kube-vip.io

## Common questions

### How should kube-vip runtime configuration files be specified, and which values win?

The manager and service commands accept strict YAML or JSON via --config-file or the config_file environment variable, with --config-file taking precedence over config_file. Values resolve in the order CLI flags, environment variables, configuration file, then command defaults. Unknown keys are rejected.

### Why might a Kubernetes LoadBalancer service stay pending when using kube-vip?

A LoadBalancer service can remain in the pending state if the required kube-vip components are not all running. Check that every component needed to create the load balancer is active.

### How do I troubleshoot WireGuard connectivity in kube-vip?

Debug most WireGuard issues on the node that currently holds leadership or on the WireGuard server itself. On the server, wg show all details the peer connections.

### What gotchas have self-hosters reported when pairing kube-vip with kubeadm on Debian 12?

One self-hoster reported that containerd initially failed and needed workarounds when pairing kubeadm on Debian 12 with kube-vip. They also reported kube-vip did not work at all from the documentation because of a known issue with no solution.

---
Source: Our Local Host (https://ourlocalhost.com/app/6221/kube-vip), the self-hosted and open-source app directory.
