SETUP-DNS(8)

📦 version 3.22.0, in alpine 3.24

💅 SETUP-DNS(8) — the manual, but make it make sense

okay so this is setup-dns, section 8 of the System Manager's Manual, and bestie it is literally the glow-up your resolver has been waiting for ✨

🌸 NAME 🌸

setup-dns — configure DNS settings 🎀

No cap, that's the whole job. It sets up your DNS. Iconic.

🦋 SYNOPSIS 🦋

setup-dns [-h] [-d DOMAIN] [IPADDR...]

Read it slowly, she's not complicated 💖

✨ DESCRIPTION ✨

setup-dns writes DNS resolver configuration to /etc/resolv.conf. That's the moment. That's the main character move. 🌟 It sets the search domain and one or more nameserver addresses, and then it's done, no extra drama.

Current values from /etc/resolv.conf or the FQDN are offered as defaults when prompting 👑 — so like, it's not making you type stuff from scratch, it's being a considerate little icon and pre-filling the vibe check for you. 🫶

Okay this part matters, pay attention:

When IPADDR arguments are given, nameserver configuration is non-interactive. Zero prompts. She just goes. 💅

The -d option supplies the search domain — but heads up, without IPADDR arguments the script still prompts for nameservers. So -d alone doesn't make it fully hands-off, bestie, you still get asked about nameservers. iykyk 🙈

🎀 OPTIONS 🎀

  • -d DOMAIN — Set the DNS search domain. That's your domain, your rules, your search. 🌈
  • -h — Display usage information and exit. The classic "help me help you" flag, then she dips. 👋

🧚 FILES 🧚

  • /etc/resolv.conf — DNS resolver configuration file. The one. The blueprint. The sacred text this whole script is writing to. 📜💜

💀 EXIT STATUS 💀

  • 0 — Success. Slay. Everything worked. 🎉
  • non-zero — An error occurred. 😭 Something went sideways, check what you typed.

🔥 SEE ALSO 🔥

🌺 AUTHORS 🌺

Natanael Copa <ncopa@alpinelinux.org> and others 🫶

bestie this page is Alpine Linux, dated 2026-06-09 — stay configured, stay iconic, and may your nameservers always resolve 💖✨🎀🦋

📦 where this page comes from