{"id":23370398,"url":"https://github.com/prajithp/letsencrypt-cpanel","last_synced_at":"2025-04-10T16:21:06.127Z","repository":{"id":63461188,"uuid":"49562578","full_name":"Prajithp/letsencrypt-cpanel","owner":"Prajithp","description":" cPanel/WHM plugin for Let's Encrypt client","archived":false,"fork":false,"pushed_at":"2018-01-30T09:03:36.000Z","size":195,"stargazers_count":180,"open_issues_count":40,"forks_count":61,"subscribers_count":20,"default_branch":"pure-perl","last_synced_at":"2025-03-24T14:09:22.144Z","etag":null,"topics":["cpanel","letsencrypt","letsencrypt-plugin","opensource","ssl-certificate","whm","whm-plugin"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Prajithp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-13T09:10:52.000Z","updated_at":"2025-02-09T04:19:45.000Z","dependencies_parsed_at":"2022-11-19T10:45:55.340Z","dependency_job_id":null,"html_url":"https://github.com/Prajithp/letsencrypt-cpanel","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prajithp%2Fletsencrypt-cpanel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prajithp%2Fletsencrypt-cpanel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prajithp%2Fletsencrypt-cpanel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prajithp%2Fletsencrypt-cpanel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Prajithp","download_url":"https://codeload.github.com/Prajithp/letsencrypt-cpanel/tar.gz/refs/heads/pure-perl","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248252663,"owners_count":21072699,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpanel","letsencrypt","letsencrypt-plugin","opensource","ssl-certificate","whm","whm-plugin"],"created_at":"2024-12-21T15:37:55.027Z","updated_at":"2025-04-10T16:21:06.104Z","avatar_url":"https://github.com/Prajithp.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"## (Deprecated) letsencrypt-cpanel \n### Notice\n I will probably be able to do maintenance and cPanel compatibility for at least a year. As far as I am aware, nobody other than me is using this. If you ARE using this plugin, please feel free to reach out for me.\n\n## Info\nThis is a cPanel/WHM plugin for the [Let's Encrypt](https://letsencrypt.org/) client. This plugin uses Perl and the WHM API, and requires a server running cPanel and WHM on it.\n\nSupport for service SSL certificates has been recently added, and is considered to be in beta. Please report any issues you find so that we may address them.\n\n### VERSION\nVersion 1.4\n\n### Requirements\n\n- CentOS 5/6/7\n- If using CentOS 5, SNI is not supported at the OS level. Therefore, you'll either need static IP addresses for each domain on the system, or you will need to be using CentOS 6 or 7.\n\n### Installation\n\n```\n/usr/local/cpanel/3rdparty/bin/git clone https://github.com/Prajithp/letsencrypt-cpanel.git\ncd letsencrypt-cpanel\n./install.sh\n```\n\nIf everything goes well, you will see a new icon in the `WHM \u003e\u003e Plugins` section. Existing certificates will be shown, and you will be able to register new SSL certificates for domains on the server that do not yet have SSL associated with it.\n\nAny SSL certificates added will automatically attempt renewal. You should not need to manually renew the certificates.\n\n### Upgrading\n\t\n```\ncd letsencrypt-cpanel\n/usr/local/cpanel/3rdparty/bin/git pull\n./upgrade.sh\n```\n\n### Uninstall\n\t\n```\ncd letsencrypt-cpanel\n./uninstall.sh\n```\n\n## Troubleshooting\n\n### Status: 400, Detail: DNS name does not have enough labels, Type: urn:acme:error:malformed\n\nSome OpenVZ VPS providers don't let hostname survive a reboot the way it needs to. Start by seeing how your hostname is formatted for your system like this:\n\n```\nhostname\n```\n\nIf you see `sub` instead of `sub.yourdomain.com`, then it's formatted incorrectly. To fix the issue, you can do the following to correct the hostname, lock down permissions, then reboot the system:\n\n```\nhostnamectl set-hostname sub.yourdomain.com\nchattr +i /etc/hostname\nreboot\n```\n\n`chattr` will ensure that even root cannot write to the file to change it. Even on reboot.\n\nIf for some reason you want to modify the file again in the future, you can do this:\n\n```\nchattr -i /etc/hostname\n```\n\n### 403 error: Authorizations for these names not found or expired\n\nLet's Encrypt verifies domains via http using the pathname `.well-known` and the subfolder `acme-challenge`, if there are any rules in `.htaccess` that redirect this folder to https (or elsewhere) the verification will fail. To exclude rewrites for the `.well-known` folder place the following line to `.htaccess` in your **document root** directly under `RewriteEngine On`:\n\n```\nRewriteRule ^.well-known(.*)$ - [L,NC]\n```\n\nIf the `.well-known` folder is requested (by Let's Encrypt) it doesn't process further rules and avoids any SSL redirection that happens below it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprajithp%2Fletsencrypt-cpanel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprajithp%2Fletsencrypt-cpanel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprajithp%2Fletsencrypt-cpanel/lists"}