AIOCOAP-RD(1)

📦
version 0.4.17 · 3 versions
, in ubuntu stonking

🌸 AIOCOAP-RD — the resource directory that literally just exists to hold your registrations 💅

okay so bestie, this is aiocoap-rd, a plain CoAP Resource Directory server, living its best life according to RFC9176 → <https://datatracker.ietf.org/doc/html/rfc9176>

it's giving "I'm a registry for CoAP endpoints and I do it with zero drama." ✨

🚨 Known Caveats (read these, fr fr)

  • It is very permissive. Not only is no security implemented.
  • This may and will make exotic choices about discoverable paths wherever it can (see StandaloneResourceDirectory documentation).
  • Split-horizon is not implemented correctly.
  • Unless enforced by security (ie. not so far), endpoint and sector names (ep, d) are not checked for their lengths or other validity.
  • Simple registrations don't cache .well-known/core contents.
💀 no cap, that security situation is a whole vibe check failure. deploy accordingly.

🫶 USAGE

usage: aiocoap-rd [-h] [--bind BIND] [--credentials CREDENTIALS]
                  [--tls-server-certificate CRT] [--tls-server-key KEY]
                  [--version] [--proxy-domain PROXY_DOMAIN] [--lwm2m-compat]
                  [--no-lwm2m-compat] [--verbose]

✨ NAMED ARGUMENTS ✨

  • --bind — host and/or port to bind to (peep --help-bind for the deets) 🎀
  • --credentials — a JSON file pointing to credentials for the server's identity/ies. 🔑
  • --tls-server-certificate — TLS certificate (chain) to present to connecting clients, in PEM format. 📜
  • --tls-server-key — TLS key to load that supports the server certificate. 🗝️
  • --version — show program's version number and exit. so iconic of it honestly 🦋
  • --proxy-domain — enable the RD proxy extension. Example: proxy.example.net will produce base URIs like coap://node1.proxy.example.net/. The names must all resolve to an address the RD is bound to. 🌐
  • --lwm2m-compat — compatibility mode for LwM2M clients that can not perform some discovery steps (moving the registration resource to /rd). 🍓
  • --no-lwm2m-compat — disable all compatibility with LwM2M clients that can not perform some discovery steps (not even accepting registrations at /rd with warnings).

Default: True

  • --verbose — increase debug log output (repeat for increased verbosity). 🔥

Default: 0

pro tip from your girl: the defaults on --no-lwm2m-compat and --verbose are exactly as listed, don't come for me.

Christian Amsüss and the aiocoap contributors.

and that's the whole page, main character energy only. version 0.4, dated Apr 04, 2026, from the aiocoap crew — slay, bye 💖🧚🌈

📦 where this page comes from