63 lines
2.5 KiB
Plaintext
63 lines
2.5 KiB
Plaintext
---
|
|
title: 'Technitium DNS'
|
|
description: "Technitium DNS Server is a self-hosted DNS server with ad-blocking and network-wide filtering capabilities."
|
|
hide_title: true
|
|
---
|
|
|
|
import { IntegrationHeader } from '@site/src/components/integrations/header';
|
|
import { IntegrationCapabilites } from '@site/src/components/integrations/widgets';
|
|
import { AddingIntegration } from '@site/src/components/integrations/adding';
|
|
import { IntegrationSecrets } from '@site/src/components/integrations/secrets';
|
|
import Alert from '@theme/Admonition';
|
|
import { technitiumDnsIntegration } from '.';
|
|
import { dnsHoleSummaryWidget } from '@site/docs/widgets/dns-hole-summary';
|
|
import { dnsHoleControlsWidget } from '@site/docs/widgets/dns-hole-controls';
|
|
|
|
<IntegrationHeader
|
|
integration={technitiumDnsIntegration}
|
|
categories={['DNS Hole']}
|
|
/>
|
|
|
|
<Alert type="note" className='my-2'>
|
|
Homarr supports Technitium DNS v11 and above. The correct API version is detected automatically - no manual configuration is required.
|
|
</Alert>
|
|
|
|
### Widgets & Capabilities
|
|
<IntegrationCapabilites
|
|
items={[{
|
|
widget: dnsHoleSummaryWidget,
|
|
},{
|
|
widget: dnsHoleControlsWidget
|
|
}]}
|
|
/>
|
|
|
|
### Adding the integration
|
|
<AddingIntegration />
|
|
|
|
### Secrets
|
|
|
|
<Alert type="info" className='my-2'>
|
|
The **API token** option is recommended. API tokens are non-expiring and do not require storing your admin password in Homarr.
|
|
Username and password authentication uses a session token that expires after inactivity, triggering a silent re-login on the next request.
|
|
</Alert>
|
|
|
|
<Alert type="warning" className='my-2'>
|
|
The **DNS Hole Controls** widget (enabling, disabling, and timed disabling of blocking) requires the token to have settings-level permissions.
|
|
The **DNS Hole Summary** widget (stats only) works with any valid token.
|
|
If Homarr cannot read the blocking status due to insufficient permissions, the status indicator will be hidden but statistics will still be shown.
|
|
</Alert>
|
|
|
|
<IntegrationSecrets secrets={[{
|
|
credentials: ['apiKey'],
|
|
steps: [
|
|
"Open the Technitium DNS web console and sign in.",
|
|
"Click on your username in the top-right corner and select \"Create API Token\".",
|
|
"Give the token a name (e.g. \"Homarr\") and click \"Create Token\".",
|
|
"Copy the generated token and paste it into the API Key field in Homarr."
|
|
]
|
|
}, {
|
|
credentials: ['username', 'password'],
|
|
steps: [],
|
|
body: "Enter your Technitium DNS admin credentials. Homarr will exchange them for a session token and transparently re-authenticate when the session expires."
|
|
}]} />
|