Feb 21, 2024: Announcing Linkerd 2.15 with support for VM workloads, native sidecars, and SPIFFE! Read more »

This is not the latest version of Linkerd!
This documentation is for an older version of Linkerd. In Linkerd 2.15 (current), this document no longer exists.

Using a Custom Cluster Domain

For Kubernetes clusters that use custom cluster domain, Linkerd must be installed using the --cluster-domain option:

linkerd install --cluster-domain=example.org \
    --identity-trust-domain=example.org \
    | kubectl apply -f -

This ensures that all Linkerd handles all service discovery, routing, service profiles and traffic split resources using the example.org domain.