Choose how your Matrix IDs will look. This decision is permanent.
@alice:example.comProfessional, clean usernames. Your Matrix ID uses your main domain.
.well-known| Type | Name | Value | TTL |
|---|---|---|---|
| A | @ (root domain) | Your server IP | 3600 |
| A | {subdomain}.example.com (you choose: matrix, chat, msg…) | Your server IP | 3600 |
.well-known delegation (the recommended method). SRV records are only needed as a fallback if you absolutely cannot serve .well-known files on your root domain.Your root domain must serve delegation files — the script sets this up automatically.
At example.com/.well-known/matrix/server:
{
"m.server": "matrix.example.com:443"
}
At example.com/.well-known/matrix/client:
{
"m.homeserver": {
"base_url": "https://matrix.example.com"
}
}
example.com already hosts a website on a different server, choose Option B during install. The script will show you exactly what .well-known JSON files to add to your existing web server. Note: This scenario has not been fully tested yet.@alice:matrix.example.comSimpler setup, no delegation needed. Perfect for personal servers.
| Type | Name | Value | TTL |
|---|---|---|---|
| A | {subdomain}.example.com (you choose: matrix, chat, msg…) | Your server IP | 3600 |
example.com),
then enter the subdomain separately (e.g. matrix). Don't enter the full address in the domain field!| Feature | Delegation | Subdomain |
|---|---|---|
| Matrix ID | @user:example.com | @user:matrix.example.com |
| DNS Records | 2 (A + A) | 1 (A only) |
| Delegation | Required | Not needed |
| Complexity | Medium | Easy |
| Best For | Public / business | Personal / private |