www.example.com*)<\/a>.<\/p>\nThe certificate request will run on the background and the status will be shown in the panel.<\/p>\n
After a certificate was received, make sure that Let’s Encrypt is the first module on the SSL Certificates list by\ndisabling all modules above Lets’s Encrypt.<\/p>\n
Now go to your site using https, you should be see your site protected by a Let’s Encrypt certificate.<\/p>\n
Certificate and key files<\/h2>\n
The certificate and key files are placed into the site sub-directory of the security directory. The subdirectory will\nbe: sitename\/letsencrypt\/<\/code><\/p>\nWhere sitename<\/em> must be replaced with the name of your site.<\/p>\nThe security directory can be found by inspecting the output of:<\/p>\n
bin\/zotonic config\n<\/code><\/pre>\nThe Zotonic security<\/em> directory can be in one of the following directories:<\/p>\n- The environment variable
ZOTONIC_SECURITY_DIR<\/code><\/li>- The
~\/.zotonic\/security<\/code> directory<\/li>- The
\/etc\/zotonic\/security<\/code> directory (only on Linux)<\/li>- The OS specific directory for application data files<\/li><\/ul>\n
The OS specific directories are:<\/p>\n
- On Unix:
~\/.config\/zotonic\/security\/<\/code><\/li>- On macOS:
~\/Library\/Application Support\/zotonic\/security\/<\/code><\/li><\/ul>\nThe default is the OS specific directory.<\/p>\n
If there is a directory priv\/security\/letsencrypt<\/code> inside your site’s OTP application folder then that directory will\nbe used.<\/p>\nAccepted Events<\/h2>\n
This module handles the following notifier callbacks:<\/p>\n
observe_ssl_options<\/code>: Return the certificates of this site using z_depcache:memo<\/code>.<\/li>observe_tick_24h<\/code>: Period tick, used to check for cert upgrade using gen_server:cast<\/code>.<\/li><\/ul>\nDelegate callbacks:<\/p>\n
event\/2<\/code> with submit<\/code> messages: request_cert<\/code>.<\/li><\/ul>","slug":"mod_ssl_letsencrypt","doc_module_config":[],"is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"075dc74471e5d89c7eaeeeffd5ed9a4c68936af59457ccbf856b7f3fec8cb980","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":320,"is_a":["meta","category"],"name":"module","title":"Modules","uri":"https:\/\/test.zotonic.com\/id\/320"},"doc_source_path":"apps\/zotonic_mod_ssl_letsencrypt\/src\/mod_ssl_letsencrypt.erl","publication_start":"2023-06-24T08:17:46Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_mod_ssl_letsencrypt\/src\/mod_ssl_letsencrypt.erl","pivot_location_lng":null,"doc_source_kind":"module","name":"doc_module_mod_ssl_letsencrypt","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2020-05-30T05:47:33Z","uri":null,"doc_status":"current","is_dependent":false,"erlang_app":"zotonic_mod_ssl_letsencrypt","publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"652b4eddf9263041a2798f290b6c867343988a3f\n","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-10-06T13:25:05Z","title_slug":"mod_ssl_letsencrypt"},"uri":"https:\/\/zotonic.com\/id\/1754","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/1754"}},"status":"ok"}