udppm(8)

💅 udppm — the UDP port mapper, bestie edition ✨

okay so real quick, before we get into it: this is udppm(8), the Universal proxy server's UDP port mapper. yes it's a section 8 page, yes it's iconic, and yes I'm gonna walk you through every single flag because we don't gatekeep here. 🫶

---

🌸 SYNOPSIS 🌸

udppm [-ds] [-l[[@]logfile]] [-iinternal_ip] [-eexternal_ip] local_port
remote_host remote_port

---

✨ DESCRIPTION ✨

udppm forwards datagrams from a local port to a remote UDP port. that's it. that's the whole thing. it's giving glorified mail forwarder but for packets 💌

---

🎀 OPTIONS 🎀

• -I — Inetd mode. Standalone service only. (so like, if you're running it under inetd, this is your girl 💅)
• -d — Daemonize. Detaches the service from the console and runs it in the background. bye bestie, we're going behind the scenes 👋
• -t — Be silenT. Do not log start/stop/accept error records. not a single word. 🤫
• -e — External address. This is the IP address of the interface the proxy should initiate datagrams from. By default, the system will decide which address to use in accordance with the routing table. (i.e. it figures it out itself, no cap ✨)
• -niPATH — (Linux only 🐧) Switch to the network namespace identified by PATH before opening the listening socket. The current namespace is saved and restored immediately after binding, so outgoing connections run in the original namespace unless -ne is also given. okay this one is lowkey the main character, pay attention 💜
• -nePATH — (Linux only 🐧) Switch to the network namespace identified by PATH after the listening socket has been bound (and after restoring from -ni if applicable). Both options accept any namespace file path (e.g. /var/run/netns/myns or /proc/PID/ns/net) and require CAP_SYS_ADMIN. yes, CAP_SYS_ADMIN — as in, you need the big-girl permissions. no shortcuts. 🔥
• -i — Internal address. The IP address the proxy accepts datagrams to. By default, connections to any interface are accepted. It's usually unsafe. 🚨 not me telling you it's unsafe in the official docs — it IS unsafe, fr fr, be careful.
• -l — Log. By default logging is to stdout. If logfile is specified, logging goes to that file. Under Unix, if @ precedes logfile, syslog is used for logging. so -l@/some/file = syslog vibes, got it? 🍓
• -s — Single packet. By default, only one client can use the udppm service, but if -s is specified, only one packet will be forwarded between client and server. This allows the service to be shared between multiple clients for single-packet services (for example, name lookups). 👑 sharing is caring
• -S — Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy crashes. stack size issues are so real, she's sensitive 😭

---

🦋 ARGUMENTS 🦋

• local_port — the port udppm accepts datagrams on 📥
• remote_host — the IP address of the host datagrams are forwarded to 📤
• remote_port — the remote port datagrams are forwarded to 🎯

---

🌈 CLIENTS 🌈

Any UDP-based application can be used as a client. Use internal_ip and local_port as the destination in the client application. All datagrams are forwarded to remote_host:remote_port. so basically you point your app at the local side and udppm does the rest — it's giving personal assistant energy, we love a service 💖

---

💀 BUGS 💀

Report all bugs to 3proxy@3proxy.org. (yes that's an email address in the BUGS section, yes you can just email them, they're nice about it, iykyk 📧)

---

👀 SEE ALSO 👀

3proxy(8), htproxy(8), ftppr(8), socks(8), pop3p(8), udppm(8), syslogd(8), and https://3proxy.org/ — go read the whole family, they're all icons 🫶

---

💜 AUTHORS 💜

3proxy is designed by Vladimir Dubrovin <vlad@3proxy.org>. thank you Vladimir, we appreciate you 🎀

---

and that's a wrap on udppm(8) bestie! go forward some datagrams, stay safe with that -i default, and remember — namespace juggling requires CAP_SYS_ADMIN. periodt. 💅✨

this has been 3proxy 0.9, dated May 2026 — mwah, love u, bye! 🌸🦋💖