OpenWrt acme-acmesh readme

I can't seem to find any sort of documentation (neither README nor wiki) for /etc/config/acme file for the current version of acme-acmesh. Am I missing it or does it not exist?

I'm fine using it from CLI, but if there's a PROCD-compatible wrapper I'd rather use that.

Upon extensive searching, I have found the Acme documentation you are looking for:

  1. 2
  2. 3

(sorry, couldn't resist)


If you mean for starting it up, yes, there is a startup script in /etc/init.d and an OpenWrt UCI config file in /etc/config/acme with example domains.

Have you tried installing luci-app-acme for configuring it?

"Example domains" is a very generous description for the default /etc/config/acme file. Sure, there are two entries, but it is far from the complete set of options.

Would be nice to not have to browse the init script code to figure out certain things, like:

  • how to switch from zerossl API to letsencrypt API?
  • do I need to indicate the reloadcmd or is the init script smart enough to restart uhttpd on its own?


Also agreed.

There are lots of things that are not well documented. My understanding is that UCI and LuCI support for acme was added to OpenWrt mostly as a method of getting certificates for devices' own LuCI interfaces so as to use TLS without having to enter exceptions in your browser. There is even a wiki page for configuring that:

That said, it could do with more and better documentation. This is true for almost all aspects of OpenWrt, where documentation lags behind new features and changes.

It would be great, once you figure out the answers you are looking for, to document your findings: Applying for OpenWrt wiki account

Not really, core OpenWrt functionality is very well documented and popular packages usually have READMEs covering them as well.

Yeah, I'd rather spend time maintaining/documenting "my" packages than create a wiki for someone else's.