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/05/14 17:15] theemstra |
plugins:letsencrypt [2016/07/04 23:29] nuxwin |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ======Let's Encrypt Plugin Documentation====== | + | ======LetsEncrypt Plugin====== |
- | This plugin allows the generation and regeneration of Let's Encrypt certificates for use in i-MSCP. | + | This plugin allows to activate Let's Encrypt for selected domains. |
- | This is a paid plugin, so it's not available for free like many other plugins. | + | =====Requirements===== |
- | ===== Requirements ===== | + | * i-MSCP Serie 1.3.x |
- | * i-MSCP versions 1.3.x | + | =====Installation===== |
- | ===== Installation ===== | + | - Download the **LetsEncrypt** plugin archive from the [[http://i-mscp.net/filebase/index.php/File/33-LetsEncrypt/|plugin store]] |
+ | - Login into the panel as admin and go to the plugin management interface | ||
+ | - Upload the **LetsEncrypt** plugin archive | ||
+ | - Click on the **Update Plugins** button | ||
+ | - Activate the plugin | ||
- | **1. Get the latest plugin version from Plugin Store** | + | =====Update===== |
- | http://i-mscp.net/filebase/index.php/Filebase/ | + | - Backup your current config file **plugins/LetsEncrypt/config.php** |
- | + | - Download the **LetsEncrypt** plugin archive from the [[http://i-mscp.net/filebase/index.php/File/33-LetsEncrypt/|plugin store]] | |
- | **2. Plugin upload and installation** | + | - Login into the panel as admin and go to the plugin management interface |
+ | - Upload the **LetsEncrypt** plugin archive | ||
+ | - Restore your **plugins/LetsEncrypt/config.php** ( compare it with new version first ) | ||
+ | - Click on the **Update Plugins** button in the plugin management interface | ||
- | * Login into the panel as admin and go to the plugin management interface | + | =====Troubleshooting===== |
- | * Upload the plugin archive | + | |
- | * Install the plugin | + | |
- | ===== Update ===== | + | ====Unknown Host Error==== |
- | **1. Get the plugin from Plugin Store** | + | Failed authorization procedure. www.domain.tld (http-01): urn:acme:error:unknownHost :: The server could not resolve a domain name :: No valid IP addresses found for www.domain.tld |
- | http://i-mscp.net/filebase/index.php/Filebase/ | + | If you get such error, be sure to add a www` CNAME DNS resource record for each of your domains |
- | **2. Backup your current plugin config** | + | =====Sponsors===== |
- | # plugins/LetsEncrypt/config.php | + | - [[https://www.ip-projects.de/|IP-Projects GmbH & Co. KG]] |
- | + | ||
- | **3. Plugin upload and update** | + | |
- | * Login into the panel as admin and go to the plugin management interface | + | =====Author===== |
- | * Upload the new plugin archive | + | |
- | * Update the plugin list | + | |
- | ===== Configuration ===== | + | * Ninos Ego <[email protected]> |
- | You can configure this plugin to your needs. | + | =====Contributor===== |
- | Check out the config.php in the plugin archive. | + | |
- | + | ||
- | Configuration values include: | + | |
- | + | ||
- | - Ordered List ItemCommand (and location) of the letsencrypt client | + | |
- | - Period before expiration, certificates will be renewed (default: 30 days before) | + | |
- | - Waiting time for retry if certificate status is pending (default: 1 hour) | + | |
- | - Path to created certificates | + | |
- | - Additional command line options passed-in to letsencrypt while creating certificate | + | |
- | - Additional command line options passed-in to letsencrypt while revoking certificate | + | |
- | - Cronjob for renewing certificates (default: run once per day) | + | |
+ | * Laurent Declercq <[email protected]> |