cookbook 'letsencrypt', '= 0.1.0', :supermarket
The letsencrypt cookbook has been deprecated
The letsencrypt cookbook has been deprecated and is no longer being maintained by its authors. Use of the letsencrypt cookbook is no longer recommended. You may find that the acme cookbook is a suitable alternative.
letsencrypt (12) Versions 0.1.0 Follow11
Install free and trusted SSL/TLS certificates from Let's Encrypt
cookbook 'letsencrypt', '= 0.1.0'
knife supermarket install letsencrypt
knife supermarket download letsencrypt
Automatically get/renew free and trusted certificates from Let's Encrypt (letsencrypt.org).
node['letsencrypt']['contact']- Contact information, default empty.
node['letsencrypt']['endpoint']- ACME server endpoint, default 'https://acme-staging.api.letsencrypt.org'. Set to
https://acme-v01.api.letsencrypt.orgfor real certificates.
node['letsencrypt']['renew']- Days before the certificate expires at which the certificate will be renewed, default 30.
Installs the required acme-client rubygem.
letsencrypt_certificate provider to request a certificate. The webserver for the domain for which you are requesting a certificate must be running on the local server. Currently only the http validation method is supported. Provide the path to your
wwwroot for the specified domain.
letsencrypt_certificate 'test.example.com' do crt '/etc/ssl/test.example.com.crt' key '/etc/ssl/test.example.com.key' method 'http' wwwroot '/var/www' end
In case your webserver needs an already existing certificate when installing a new server you will have a bootstrap problem. Webserver cannot start without certificate, but the certificate cannot be requested without the running webserver. To overcome this a self-signed certificate can be generated with the
letsencrypt_selfsigned 'test.example.com' do crt '/etc/ssl/test.example.com.crt' key '/etc/ssl/test.example.com.key' end
A working example can be found in the included
acme_client test cookbook.
The kitchen includes a
boulder server to run the integration tests with, so testing can run locally without interaction with the online API's.
- Fork the repository on Github
- Create a named feature branch (like
- Write your change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request using Github
License and Authors
Authors: Thijs Houtenbos email@example.com
This cookbook has no specified dependencies.
This file is used to list changes made in each version of the acme cookbook.
- Thijs Houtenbos - Initial release
Check the Markdown Syntax Guide for help with Markdown.
The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.