Domain Verification

IOTMER requires proof of domain ownership before allowing it to be used as an MQTT endpoint.

DNS TXT record method

1. After adding your domain, the console shows a TXT record value
2. Add a DNS TXT record at your domain registrar:
   • Type: TXT
   • Name: _iotmer-verification.<yourdomain.com>
   • Value: <verification-token-shown-in-console>
3. Wait for DNS propagation (typically 1–5 minutes, up to 48 hours in edge cases)
4. Click Verify in the console

Check verification status

GET /workspaces/{id}/domains/{domain_id}

The verified field will be true once ownership is confirmed.

Troubleshooting

• DNS propagation can be slow — wait at least 5 minutes before retrying
• Verify the TXT record is at the correct subdomain: _iotmer-verification.<yourdomain.com>
• Use dig TXT _iotmer-verification.<yourdomain.com> to confirm the record is visible