MINIUPNPD(8)

📦
version 2.3.11 · 2 versions
, in alpine 3.24, arch rolling, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 miniupnpd — UPnP Internet Gateway Device Daemon 💖

okay so bestie, welcome to miniupnpd(8) from the System Manager's Manual ✨ this is the page for the UPnP Internet Gateway Device Daemon and honestly? she's kind of a big deal. let's get into it 🫶

✨ NAME ✨

miniupnpd — UPnP Internet Gateway Device Daemon 💅

🌸 SYNOPSIS 🌸

miniupnpd [--version] [-f config_file] [-i ext_ifname] [-I ext_ifname6]
[-o ext_ip] [-a listening_ip] [-p port] [-d] [-U] [-S0] [-N] [-u uuid]
[-s serial] [-m model_number] [-t notify_interval] [-P pid_filename] [-B
down up] [-w url] [-r clean_ruleset_interval] [-A permission rule] [-b
BOOTID] [-1]

🦋 DESCRIPTION 🦋

so what does she do? miniupnpd acts as a UPnP Internet Gateway Device, no cap. she's literally designed to run on the gateway sitting between the internet and a NAT'ed LAN. 🏠✨

and the whole point? she provides an interface — as defined in the UPnP standard — so clients on the LAN can ask for port redirections. that's it, that's the gig. main character energy only 👑

💅 OPTIONS 💅

  • -f config_file — load the config from file. 📄
  • -i ext_ifname — the interface used to connect to the internet. 🌐
  • -o ext_ip — the address used to connect to the internet. if you don't specify one, the default address of the interface gets used instead. 💫
  • -a listening_ip — the address on the LAN. and bestie, plot twist: the -a option can be used multiple times if your LAN is subdivised in several subnetworks. 🏘️
  • -p port — the port used for HTTP. 🔌
  • -d — debug mode: do not go to background, output messages on console, and do not filter out low priority messages. she's loud and she's proud 🗣️
  • -U — report system uptime instead of daemon uptime to clients. ⏰
  • -S0 — disable "secure" mode, so clients can only add mappings to other IPs. 👀
  • -N — enable NAT-PMP and PCP functionality. 🔥
  • -u uuid — set the uuid of the UPnP Internet Gateway Device. 🆔
  • -s serial — the serial number for the UPnP Internet Gateway Device. 🔢
  • -m model_number — the model number for the UPnP Internet Gateway Device. 🏷️
  • -t notify_interval — SSDP notify interval, in seconds. default is 900 seconds. SSDP announce messages get broadcasted at this interval. 📣
  • -P pid_filename — the pid file. default is /var/run/miniupnpd.pid. 🗂️
  • -B down up — the download and upload bitrates reported to clients. ⬇️⬆️
  • -w url — the presentation url. default is the first address on LAN, port 80. 🔗
  • -r clean_ruleset_interval — the (minimum) interval between unused rules cleaning checks. 🧹
  • -A permission rule — use the following syntax for permission rules:
(allow|deny) (external port range) ip/mask (internal port range)

examples:

"allow 1024-65535 192.168.1.0/24 1024-65535"
"deny 0-65535 0.0.0.0/0 0-65535"

🎀

  • -b BOOTID — sets the value of the BOOTID.UPNP.ORG SSDP header. 📨
  • -1 — force reporting IGDv1 in rootDesc when compiled as IGDv2. use with care ⚠️

🌈 SEE ALSO 🌈

minissdpd(1) · miniupnpc(3) 🫶

💀 BUGS 💀

this section is empty in the original. no bugs listed, no tea spilled, nothing. iconic of her honestly. ✨

and that's the whole page, bestie!! this was MINIUPNPD(8) from the System Manager's Manual — same title up top, same title down at the bottom, and no date on that footer either, so don't come for me about timestamps. periodt. 💖🎀🦋

📦 where this page comes from