Error during renewal : KeyError: 'handle_modules'


My domain is:

I ran this command: ./letsencrypt-auto renew

It produced this output:

An unexpected error occurred:
KeyError: ‘handle_modules’
Please see the logfile ‘/tmp/tmpumk33f’ for more details.

Contents of the log ‘/tmp/tmpumk33f’ :

2018-09-06 12:06:21,640:DEBUG:certbot.main:certbot version: 0.27.0
2018-09-06 12:06:21,640:DEBUG:certbot.main:Arguments: [’–version’]
2018-09-06 12:06:21,640:DEBUG:certbot.main:Discovered plugins: PluginsRegistry(PluginEntryPoint#apache,PluginEntryPoint#manual,PluginEntryPoint#nginx,PluginEntryPoint#null,PluginEntryPoint#standalone,PluginEntryPoint#webroot)
2018-09-06 12:06:21,643:DEBUG:certbot.log:Exiting abnormally:
Traceback (most recent call last):
File “/opt/”, line 11, in
File “/opt/”, line 1345, in main
args = cli.prepare_and_parse_args(plugins, cli_args)
File “/opt/”, line 1243, in prepare_and_parse_args
_plugins_parsing(helpful, plugins)
File “/opt/”, line 1458, in _plugins_parsing
File “/opt/”, line 840, in add_plugin_args
plugin_ep.plugin_cls.inject_parser_options(parser_or_group, name)
File “/opt/”, line 81, in inject_parser_options
return cls.add_parser_arguments(add)
File “/opt/”, line 159, in add_parser_arguments
add(“handle-modules”, default=cls.OS_DEFAULTS[“handle_modules”],
KeyError: ‘handle_modules’
2018-09-06 12:06:21,643:ERROR:certbot.log:An unexpected error occurred:

My web server is (include version): OpenSuse 42.3

Thanks !


I have the same issue, with the same OS version. Tried removing /opt/ and bootstraping again, but the same error occurs.


Yes, same here. Any idea/support ?


I had the same problem on OpenSuse 42.3.

If you look at the “” file in the directory


you will see that someone recently modified it to create the “handle_mods” element instead of the “handle_modules” element in the OS_DEFAULTS array.

If you look in the other “override_” files, you will see that they all use the “handle_modules” element name.

I changed “handle_mods=False” to “handle_modules=False” and it now works fine.


Letsencrypt-auto fails

Thanks for the investigation ! It works now :slight_smile:


Someone (one of you?) opened an issue on Certbot’s GitHub.


Thanks for reporting, and thanks to @DLoader for investigating! We’ve put out a point release, 0.27.1, which should fix this issue. Re-run certbot-auto to upgrade :smiley:


This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.