DNS Providers
Automatic DNS record management and ACME challenge support.
Mantræ integrates with various DNS providers to automatically manage records for your routers and facilitate Let's Encrypt DNS challenges.
Supported Providers
Cloudflare
Using API Tokens.
PowerDNS
Via REST API.
Technitium
Self-hosted DNS.
PiHole
Local DNS management.
Adding a Provider
- Navigate to the DNS section (globe icon) in the sidebar.
- Click Add Provider.
- Select your provider type and enter the required credentials.
Provider Specifics
- API Token: A scoped token with
DNS:Editpermissions for the zones you wish to manage.
- API URL: The base URL of your PowerDNS API.
- API Key: The secret key configured in PowerDNS.
- API URL: Your Technitium DNS API endpoint.
- API Key: Your API authentication key.
- API URL: Your PiHole API endpoint.
- API Token: Your PiHole API token.
Using DNS Providers
Automatic DNS Records
When you assign a DNS provider to a router:
- Mantræ creates DNS
AorCNAMErecords for the router's host rule. - Existing records are checked to avoid duplicates.
- You can set a provider as Default to have it automatically assigned to all new routers.
Certificate Management (ACME)
DNS providers enable effortless TLS certificates via the DNS-01 challenge:
- Mantræ provides the necessary credentials to Traefik.
- Traefik performs the ACME challenge by creating a temporary TXT record.
- Once validated, Let's Encrypt issues the certificate.
Security
- Credentials are encrypted at rest in the Mantræ database.
- DNS providers are scoped to Profiles, ensuring isolation.
- We recommend using scoped tokens with minimal permissions.