59 lines
2.0 KiB
Plaintext
59 lines
2.0 KiB
Plaintext
---
|
|
title: "DNS Hole Controls"
|
|
description: "Control Pi-hole, AdGuard Home, or Technitium DNS from your dashboard."
|
|
hide_title: true
|
|
---
|
|
|
|
import { WidgetHeader } from "@site/src/components/widgets/header";
|
|
import { AddingWidget } from "@site/src/components/widgets/adding";
|
|
import { WidgetConfig } from "@site/src/components/widgets/configuration";
|
|
import { WidgetIntegrations } from "@site/src/components/widgets/integrations";
|
|
import { dnsHoleControlsWidget } from ".";
|
|
import { adguardHomeIntegration } from "@site/docs/integrations/adguard-home";
|
|
import { piHoleIntegration } from "@site/docs/integrations/pi-hole";
|
|
import { technitiumDnsIntegration } from "@site/docs/integrations/technitium-dns";
|
|
|
|
<WidgetHeader widget={dnsHoleControlsWidget} categories={["DNS Hole"]} />
|
|
|
|
The DNS Hole Controls widget enables, disables, or temporarily pauses one or more DNS services. Actions require Interact
|
|
access. Healthy controls remain available when another selected integration fails.
|
|
|
|
### Screenshots
|
|
|
|
import bigSize from "./img/big.png";
|
|
import smallSize from "./img/small.png";
|
|
|
|
<img src={bigSize} alt="dns-hole-controls big-size with-toggle-all-buttons" width={256} height={128} />
|
|
<img src={smallSize} alt="dns-hole-controls small-size no-toggle-all-buttons" width={128} height={128} />
|
|
|
|
### Supported Integrations
|
|
|
|
<WidgetIntegrations
|
|
items={[
|
|
{
|
|
integration: adguardHomeIntegration,
|
|
},
|
|
{
|
|
integration: piHoleIntegration,
|
|
},
|
|
{
|
|
integration: technitiumDnsIntegration,
|
|
},
|
|
]}
|
|
/>
|
|
|
|
### Interactions
|
|
|
|
- Enable or disable one DNS service by clicking its status badge.
|
|
- Temporarily disable one service with the clock action.
|
|
- Apply an action to all available services from the top action row. Homarr keeps successful results visible and reports how many sources failed.
|
|
- Interaction controls only appear when the current user has permission for that integration.
|
|
|
|
### Adding the widget
|
|
|
|
<AddingWidget />
|
|
|
|
### Configuration
|
|
|
|
<WidgetConfig configuration={dnsHoleControlsWidget.configuration} />
|