This is not the latest version of Linkerd!
This documentation is for an older version of Linkerd. You may want the Linkerd 2.14 (current) documentation instead.

Using a Custom Cluster Domain

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

# first, install the Linkerd CRDs:
linkerd install --crds | kubectl apply -f -

# next, install the Linkerd control plane, using the custom cluster domain:
linkerd install \ \
    | kubectl apply -f -

# The Linkerd Viz extension also requires a similar setting:
linkerd viz install --set | kubectl apply -f -

# And so does the Multicluster extension:
linkerd multicluster install --set | kubectl apply -f -

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