{"id":15683890,"url":"https://github.com/cytopia/letsencrypt-watch","last_synced_at":"2025-05-07T14:26:45.415Z","repository":{"id":147859285,"uuid":"55056074","full_name":"cytopia/letsencrypt-watch","owner":"cytopia","description":"[sh] certwatch cron implementation for letsencrypt certificates","archived":false,"fork":false,"pushed_at":"2016-03-31T08:47:55.000Z","size":13,"stargazers_count":10,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-31T10:51:28.515Z","etag":null,"topics":["certificate","letsencrypt","letsencrypt-watch","nginx"],"latest_commit_sha":null,"homepage":"https://www.everythingcli.org","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cytopia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-03-30T11:01:03.000Z","updated_at":"2023-12-05T08:54:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"a1834591-4034-4d27-bc09-15f507e2b3d1","html_url":"https://github.com/cytopia/letsencrypt-watch","commit_stats":{"total_commits":15,"total_committers":1,"mean_commits":15.0,"dds":0.0,"last_synced_commit":"18b19e44508c0b94e5e2d18ff0142520e958622e"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cytopia%2Fletsencrypt-watch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cytopia%2Fletsencrypt-watch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cytopia%2Fletsencrypt-watch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cytopia%2Fletsencrypt-watch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cytopia","download_url":"https://codeload.github.com/cytopia/letsencrypt-watch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252894132,"owners_count":21820925,"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":["certificate","letsencrypt","letsencrypt-watch","nginx"],"created_at":"2024-10-03T17:09:04.489Z","updated_at":"2025-05-07T14:26:45.396Z","avatar_url":"https://github.com/cytopia.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# letsencrypt-watch\n\nIndependent [certwatch](http://linux.die.net/man/1/certwatch) cron script for [letsencrypt](https://letsencrypt.org) certificates.\n\n---\n\nSee also: **[nginx-certwatch](https://github.com/cytopia/nginx-certwatch)**\n\n---\n\nThis was mainly built as I am using [nginx](http://nginx.org/) and the normal `/etc/cron.daily/certwatch` script is not picking up the SSL certificates in my vhosts as it relies on [apache](apache.org) and quits if it is not found:\n```shell\ntest -x /etc/httpd/modules/libmodnss.so || return 0\n# and\ntest -r /etc/httpd/conf/httpd.conf    || return 0\n```\n\nAdd this shell script to your crontab (or copy it to `/etc/cron.daily/`) to be notified via email when your certificates reach expiry.\nThe default behavior (without arguments) is to notify the root user, once the certificates will expire in 30 days or less.\n\n\n## Usage\n\nAll command line arguments are optional and if not specified, the default values are used.\n\n```shell\n$ letsencrypt-watch [--period=30] [--email=user@mail.tld] [--path=/etc/letsencryt]\n\n --period=XX       specify period in days to check for (Default: 30)\n --email=root      specify email to send notifications if period expires (Default: root)\n --path=/etc/path  specify letsencrypt base path (Default: /etc/letsencrypt) \n\n```\n\n## Cronjob\n\nPut the following example in your cron daily and replace the email with your own.\n\n```shell\n@daily /path/to/letsencrypt-watch --email=cytopia@everythingcli.org\n```\nor\n```shell\n0 0 * * * /path/to/letsencrypt-watch --email=cytopia@everythingcli.org\n```\n\n## Note\n\n* 100% POSIX compatible\n* No [bashism](http://mywiki.wooledge.org/Bashism)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcytopia%2Fletsencrypt-watch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcytopia%2Fletsencrypt-watch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcytopia%2Fletsencrypt-watch/lists"}