diff options
| author | Paul Buetow <paul@buetow.org> | 2026-02-08 16:11:30 +0200 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-02-08 16:11:30 +0200 |
| commit | 3cf3637cce1a561214973612378fec15d27fbb7e (patch) | |
| tree | 692508d377ed8c56ee1b2f303a26c881b48dc72b | |
| parent | 7db20447212c0b850849f9cf5aa04f525d59bb8c (diff) | |
docs(pihole): add DNS toggle script documentation and improve setup instructions
Added quick toggle script section to README with usage examples. Reorganized
client configuration into quick toggle (recommended) and manual sections for
better clarity. The toggle script provides an easy way to enable/disable
Pi-hole DNS on Fedora laptops without remembering NetworkManager commands.
Co-authored-by: Cursor <cursoragent@cursor.com>
| -rw-r--r-- | f3s/pihole/README.md | 39 |
1 files changed, 30 insertions, 9 deletions
diff --git a/f3s/pihole/README.md b/f3s/pihole/README.md index 6f87e74..71d9ed1 100644 --- a/f3s/pihole/README.md +++ b/f3s/pihole/README.md @@ -31,21 +31,42 @@ Pi-hole DNS is available on both the Wireguard mesh and LAN networks: #### Linux (Fedora/NetworkManager) +##### Quick Toggle (Recommended) + +If you have the dotfiles repository, use the toggle script: + +```bash +# Toggle Pi-hole DNS on/off +pihole-dns-toggle + +# Or use specific commands +pihole-dns-toggle on # Enable Pi-hole DNS +pihole-dns-toggle off # Disable Pi-hole (use DHCP DNS) +pihole-dns-toggle status # Show current status +``` + +The script is located at `~/git/dotfiles/scripts/pihole-dns-toggle` and automatically detects your active network connection. + +##### Manual Configuration + Configure your network connection to use Pi-hole with automatic failover: ```bash -# List active connections +# First, identify your active connection name nmcli connection show --active -# For WiFi connection (replace with your connection name) -nmcli con mod "Your-WiFi-Name" ipv4.dns "192.168.1.120 192.168.1.121 192.168.1.122 192.168.1.1" -nmcli con mod "Your-WiFi-Name" ipv4.ignore-auto-dns yes -nmcli con up "Your-WiFi-Name" +# Configure DNS servers (replace CONNECTION_NAME with your actual connection name from above) +nmcli con mod "CONNECTION_NAME" ipv4.dns "192.168.1.120 192.168.1.121 192.168.1.122 192.168.1.1" +nmcli con mod "CONNECTION_NAME" ipv4.ignore-auto-dns yes +nmcli con up "CONNECTION_NAME" +``` -# For wired connection (replace with your connection name) -nmcli con mod "Your-Wired-Name" ipv4.dns "192.168.1.120 192.168.1.121 192.168.1.122 192.168.1.1" -nmcli con mod "Your-Wired-Name" ipv4.ignore-auto-dns yes -nmcli con up "Your-Wired-Name" +Example for a WiFi connection named `www_irregular_ninja`: + +```bash +nmcli con mod "www_irregular_ninja" ipv4.dns "192.168.1.120 192.168.1.121 192.168.1.122 192.168.1.1" +nmcli con mod "www_irregular_ninja" ipv4.ignore-auto-dns yes +nmcli con up "www_irregular_ninja" ``` DNS servers are tried in order: |