73 lines
2.6 KiB
Plaintext
73 lines
2.6 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.",
|
|
},
|
|
]}
|
|
/>
|