---
title: "Set general DNS parameters"
method: POST
path: "/dns_config"
tags: ["global"]
---

# Set general DNS parameters

`POST /dns_config`

## Request

- Base URL: `/control` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/control/dns_config`
- Auth: HTTP basic

## Request body

- DNSConfig: Query log configuration
  - `bootstrap_dns` string[]: Bootstrap servers, port is optional after colon. Empty value will reset it to default values.
  - `upstream_dns` string[]: Upstream servers, port is optional after colon. Empty value will reset it to default values.
  - `upstream_dns_file` string
  - `protection_enabled` boolean
  - `dhcp_available` boolean
  - `ratelimit` integer
  - `blocking_mode` 'default' | 'refused' | 'nxdomain' | 'null_ip' | 'custom_ip'
  - `blocking_ipv4` string
  - `blocking_ipv6` string
  - `edns_cs_enabled` boolean
  - `disable_ipv6` boolean
  - `dnssec_enabled` boolean
  - `cache_size` integer
  - `cache_ttl_min` integer
  - `cache_ttl_max` integer
  - `cache_optimistic` boolean
  - `upstream_mode` '' | 'parallel' | 'fastest_addr'
  - `use_private_ptr_resolvers` boolean
  - `resolve_clients` boolean
  - `local_ptr_upstreams` string[]: Upstream servers, port is optional after colon. Empty value will reset it to default values.

## Response `200`

OK

---

[API](https://skmtc.dev/guardllamanet/apis/adguard-home.md) - [All operations](https://skmtc.dev/guardllamanet/apis/adguard-home/llms.txt) - [OpenAPI document](https://skmtc.dev/guardllamanet/apis/adguard-home/revisions/14ff21aeb363?raw)