magic-ip-address is a Kubernetes daemonset to implement magic IP addresses, that are useful to serve node-local services.

Magic IP addresses are static IP addresses that are well-known in your cluster. They are typically assigned to daemonset pods, so that the pods are accessible from other consumer pods that are collocated on the same nodes.

Under the hood, magic-ip-address periodically polls the Kubernetes API to find one of targeted daemonset pods that are collocated on the same node as the magic-ip-address pod, by matching the pod selector. The targeted daemonset pods are assigned the magic IP address like, which can then be accessed by other pods.

One of typical use-cases of this project is to connect your applicaton pod to a Datadog’s dd-agent, dd-zipkin, Elastic’s apm-server, zipkin-gcp agent pods. From your application, just point your tracer to the collector endpoint netfiler/iptables will redirect packets to the agent pod on the same node according to pod selector you’ve provided.

A possible alternative to use magic-ip-address is to use the downward API to obtain the IP address of the node, while running the agent pod with hostNetwork: true. However, it has two downsides. One is that you have to open up your network to allow pods to directly access the nodes running them, which results in a extra attack surface. Another alternative would be to use a deployment, which means that you’re giving up adding a meaningful node-related metadata(node’s ip address, name, namespace, and labels that your application pod is running on) to the traces collected by the agents.

In contrast to the two alternatives, magic-ip-address allows you add meaningful node metadata to your application traces, without exposing the agent pods via the host network.

Tell us about a new Kubernetes application


Never miss a thing! Sign up for our newsletter to stay updated.


Discover and learn about everything Kubernetes