This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
plugins:letsencrypt [2016/11/23 16:26] nuxwin [LetsEncrypt Plugin] |
plugins:letsencrypt [2016/11/23 16:28] nuxwin [Let's Encrypt registration] |
||
---|---|---|---|
Line 2: | Line 2: | ||
<WRAP center round important 60%> | <WRAP center round important 60%> | ||
- | **Be aware that this documentation is always reffering to the latest LetsEncrypt plugin version.** | + | **Be aware that this documentation is always referring to the latest LetsEncrypt plugin version.** |
</WRAP> | </WRAP> | ||
Line 20: | Line 20: | ||
You can install these packages by executing the following commands: | You can install these packages by executing the following commands: | ||
- | <konsole root> | + | # apt-get update |
- | apt-get update | + | # apt-get install -y libarray-diff-perl libconvert-asn1-perl libdatetime-format-strptime-perl |
- | apt-get install -y libarray-diff-perl libconvert-asn1-perl libdatetime-format-strptime-perl | + | |
- | </konsole> | + | |
===== Installation ===== | ===== Installation ===== | ||
Line 47: | Line 45: | ||
===== Manual execution of the certbot client ===== | ===== Manual execution of the certbot client ===== | ||
- | You should avoid execute the `Certbot` client manually, or even through your own scripts, without knowing what your are doing. If you really want execute the `Certbot` client manually, you should at least reuse the email that is used by this plugin. You can find the email address in the /etc/imscp/imscp.conf file (DEFAULT_ADMIN_ADDRESS parameter). | + | You should avoid execute the Certbot client manually, or even through your own scripts, without knowing what your are doing. If you really want execute the `Certbot` client manually, you should at least reuse the email that is used by this plugin. You can find the email address in the /etc/imscp/imscp.conf file (DEFAULT_ADMIN_ADDRESS parameter). |
Be aware that not support will be given if following a manual invocation of the Certbot client, one or many of your SSL lineages are in inconsistent states. | Be aware that not support will be given if following a manual invocation of the Certbot client, one or many of your SSL lineages are in inconsistent states. | ||
Line 53: | Line 51: | ||
===== Certbot client version ===== | ===== Certbot client version ===== | ||
- | It is possible to use latest released version or development version of the Certbot client by changing the value of the `certbot_version` configuration parameter in the plugin configuration file. Be aware that usage of the development version is discouraged in production environments. | + | It is possible to use latest released version or development version of the Certbot client by changing the value of the **certbot_version** configuration parameter in the plugin configuration file. Be aware that usage of the development version is discouraged in production environments. |
===== Let's Encrypt registration ===== | ===== Let's Encrypt registration ===== | ||
Line 59: | Line 57: | ||
The plugin automatically process your Let's Encrypt account registration, using the administrator email address that you have provided during i-MSCP setup phase. If you need change that email, you must not forget to run the following command to update your Let's Encrypt account: | The plugin automatically process your Let's Encrypt account registration, using the administrator email address that you have provided during i-MSCP setup phase. If you need change that email, you must not forget to run the following command to update your Let's Encrypt account: | ||
- | <konsole root> | + | # certbot-auto register --update-registration --email <new_email> |
- | certbot-auto register --update-registration --email <new_email> | + | |
- | </konsole> | + | |
- | where `<new_email>` is your new email address. | + | where **<new_email>** is your new email address. |
If you don't do so, a new account will be created using the new email address and there will be inconsistencies with SSL certificate lineages, making the plugin unable to work properly. | If you don't do so, a new account will be created using the new email address and there will be inconsistencies with SSL certificate lineages, making the plugin unable to work properly. |