Using Custom Cluster Domain

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

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

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

Note

Note that the identity trust domain must match the cluster domain for mTLS to work.

Note

Changing the cluster domain while upgrading Linkerd isn’t supported.