ikidns(1)

💖 ikidns — bestie edition 💖

okay so you found the ikidns(1) page in the General Commands Manual and honestly? iconic. sit down, hydrate, let's go 🫶

✨ NAME ✨

ikidns — the ikiwiki-hosting dns helper 💅

✨ SYNOPSIS ✨

ikidns subcommand options

✨ DESCRIPTION ✨

okay so here's the lore 👑

Every single web server needs to be able to update the DNS when a site gets brought up on it. that's just the rule. and the way they do that is by talking to the master DNS server, using nsupdate(1) and a key 🔑 no cap.

and that's literally where ikidns comes in. she handles management of the keys, and she configures the master DNS server to accept them — for each configured toplevel domain name. main character energy fr fr 👑

✨ FILES ✨

• /etc/bind/$domain/db/zonefile — this is the zone file for a domain, bestie. if it doesn't exist yet, a stub file will be generated from a template, but it probably needs to be configured. that's on you 🌸 And since nsupdate(1) is used to add subdomains, bind will first add them to a journal file, and later update this file to list them. the way that she journals first and updates later… obsessed 💜
• /etc/ikiwiki-hosting/ikiwiki-hosting.conf — this is the config file that gets read by default 📖
• /etc/ikiwiki-hosting/templates/ — this one holds templates of bind config and zone files 🎀

✨ EXAMPLES ✨

get you a bestie who can copy a key to a server, periodt:

 scp $(ikidns createkey $newserver)
 $newserver:/etc/ikiwiki-hosting/keys/dns/

and then:

 ikidns setupbind

that's it. that's the whole vibe ✨

✨ SEE ALSO ✨

• ikisite(1) — go read her too, iykyk 💖

✨ AUTHOR ✨

Joey Hess <joey@ikiwiki.info> — the founder of the whole vibe, we stan 🫶

and that's the page!! this is the ikidns(1) manual page from the General Commands Manual — you've reached the very end, bestie, so go forth and manage those keys 🌈💖🦋