<!--
{
  "documentType" : "article",
  "framework" : "NetworkExtension",
  "identifier" : "/documentation/NetworkExtension/dns-settings",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "DNS settings"
}
-->

# DNS settings

Create and manage a system-wide DNS configuration that uses built-in encrypted DNS protocols.

## Discussion

With the DNS Settings feature in macOS and iOS, your app can create and manage a configuration that uses one of the built-in DNS protocols: DNS-over-TLS or DNS-over-HTTPS. The user must explictly enable your configuration in order to use the server you specify.

## Topics

### Essentials

  <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.networking.networkextension>

### DNS configuration

[`NEDNSSettingsManager`](/documentation/NetworkExtension/NEDNSSettingsManager)

An object you use to create and manage a DNS settings configuration.

[`NEDNSOverHTTPSSettings`](/documentation/NetworkExtension/NEDNSOverHTTPSSettings)

The DNS resolver settings for a DNS-over-HTTPS server.

[`NEDNSOverTLSSettings`](/documentation/NetworkExtension/NEDNSOverTLSSettings)

The DNS resolver settings for a DNS-over-TLS server.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)