diff --git a/docs/examples/federation-over-tls/README.md b/docs/examples/federation-over-tls/README.md
index 2e8372b61..5718c942c 100644
--- a/docs/examples/federation-over-tls/README.md
+++ b/docs/examples/federation-over-tls/README.md
@@ -8,6 +8,9 @@ First, please follow [TLS example](../tls) to create a TLS secret. Alternatively
 The certificate expects to have a `ClusterIssuer` named `selfsigned-issuer`. Feel free to adapt this value accordingly to your
 cert-manager installation.
 
+**NOTE** `certificate.yaml` contains the word "examples" multiple times - in the `namespace` and `dnsNames` properties.
+You need to replace all occurrences with your desired namespace. `dnsNames` values need to contain the actual namespace name this cluster will be deployed to, otherwise TLS will fail due to hostname mismatch.
+
 In addition, you have to create a ConfigMap to import the definitions with the topology pre-defined.
 
 ```bash
diff --git a/docs/examples/federation-over-tls/certificate.yaml b/docs/examples/federation-over-tls/certificate.yaml
index 6478e0705..f05babd67 100644
--- a/docs/examples/federation-over-tls/certificate.yaml
+++ b/docs/examples/federation-over-tls/certificate.yaml
@@ -2,9 +2,12 @@ apiVersion: cert-manager.io/v1
 kind: Certificate
 metadata:
   name: selfsigned-cert
+  namespace: examples
 spec:
   dnsNames:
-    - "federation-server-0.federation-nodes.default"
+    # The following values need to contain the actual namespace you are deploying to;
+    # replace "examples" with your desired namespace
+    - "federation-server-0.federation-nodes.examples"
   secretName: tls-secret
   issuerRef:
     kind: ClusterIssuer
diff --git a/docs/examples/import-definitions/test.sh b/docs/examples/import-definitions/test.sh
index 76d1cfbb9..3d59d73ac 100755
--- a/docs/examples/import-definitions/test.sh
+++ b/docs/examples/import-definitions/test.sh
@@ -5,7 +5,7 @@ pushd "$(mktemp -d)" || exit 1
 set -x
 kubectl exec import-definitions-server-0 -- rabbitmqadmin \
   --format=raw_json --vhost=hello-world --username=hello-world \
-  --password=hello-world --host=import-definitions.default.svc \
+  --password=hello-world --host=import-definitions.examples.svc \
   list queues &> queues.json
 
 [[ "$(jq '.[0].name' queues.json)" == '"cq1"' ]] || exit 2