https://github.com/exc4/macos-dns-persist
This repository offers a solution to persist DNS settings across all network connections on macOS using a launch service.
https://github.com/exc4/macos-dns-persist
cloudflared dns dnsmasq macos stubby
Last synced: 13 days ago
JSON representation
This repository offers a solution to persist DNS settings across all network connections on macOS using a launch service.
- Host: GitHub
- URL: https://github.com/exc4/macos-dns-persist
- Owner: exc4
- Created: 2024-12-15T13:01:12.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-18T08:55:34.000Z (over 1 year ago)
- Last Synced: 2025-07-27T03:45:26.051Z (10 months ago)
- Topics: cloudflared, dns, dnsmasq, macos, stubby
- Language: Shell
- Homepage:
- Size: 25.4 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# macOS Persist DNS Resolvers
This repository offers a solution to persist DNS settings across all network connections on macOS using a launch service.
macOS uses different DNS settings for various network connections, making it challenging to maintain consistent DNS settings when frequently connecting to new networks. However, you may prefer to use specific DNS resolvers across all connections, particularly when employing DNS caching tools like Dnsmasq or utilizing DNS protection services such as Stubby, Cloudflared and other tools.
This repository helps you set the same DNS resolvers for all network connections and persist these settings by using a launch service. The service executes the settings periodically and upon network changes to ensure the DNS settings remain consistent.
## Files
- `io.github.exc4.dnspersist.plist`: Launch service configuration file.
- `dnspersist.sh`: Shell command script.
## How to Use
To install the service, run the following commands:
```bash
git clone https://github.com/exc4/macos-dns-persist.git
cd macos-dns-persist
# Set the DNS configuration for persistence.
# You can specify multiple DNS servers separated by spaces.
echo "127.0.0.1 ::1" | sudo tee /etc/dnspersist.conf
sudo ./dnspersist.sh --install
```
After installation, the script applies the DNS settings immediately and continues to persist the setting periodically and whenever the network changes.
## How to Uninstall
```bash
dnspersist --uninstall
```
## How to Configure DNS Persistence
To set the DNS servers, edit the `/etc/dnspersist.conf` file.
```bash
# use local DNS server, ensure there is one running on the system
# you can choose dnsmasq, stubby, cloudflared and etc.
echo "127.0.0.1 ::1" | sudo tee /etc/dnspersist.conf
# use public DNS servers
echo "8.8.8.8 8.8.4.4" | sudo tee /etc/dnspersist.conf
# use default DNS servers obtained from DHCP
echo "DEFAULT" | sudo tee /etc/dnspersist.conf
```
After editing the file, run the following command to apply the changes:
```bash
sudo dnspersist
```
The default time interval for the periodic execution is 30 minutes. You can adjust this interval by editing the `/Library/LaunchDaemons/io.github.exc4.dnspersist.plist` file, and changing the `StartInterval` value.
After editing the file, run the following command to apply the changes:
```bash
sudo launchctl unload /Library/LaunchDaemons/io.github.exc4.dnspersist.plist
sudo launchctl load /Library/LaunchDaemons/io.github.exc4.dnspersist.plist
```
## License
This project is licensed under the MIT License.
## Copyright
This script is inspired by the original script from stubby: [stubby-setdns-macos.sh](https://github.com/getdnsapi/stubby/blob/develop/macos/stubby-setdns-macos.sh).
Original Copyright (c) 2017, Sinodun Internet Technologies Ltd, NLnet Labs. All rights reserved.
The script has been modified to function as a service to persist DNS settings on macOS.