https://github.com/cytopia/nginx-certwatch
[sh] certwatch cron implementation for nginx vhosts
https://github.com/cytopia/nginx-certwatch
Last synced: about 1 month ago
JSON representation
[sh] certwatch cron implementation for nginx vhosts
- Host: GitHub
- URL: https://github.com/cytopia/nginx-certwatch
- Owner: cytopia
- License: mit
- Created: 2016-03-31T08:18:17.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-01-23T17:21:10.000Z (over 6 years ago)
- Last Synced: 2025-03-31T04:32:21.087Z (2 months ago)
- Language: Shell
- Homepage:
- Size: 6.84 KB
- Stars: 13
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nginx-certwatch
Independent [certwatch](http://linux.die.net/man/1/certwatch) cron script for all [nginx](http://nginx.org/) ssl vhosts.
---
See also: **[letsencrypt-watch](https://github.com/cytopia/letsencrypt-watch)**
---
This 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:
```shell
test -x /etc/httpd/modules/libmodnss.so || return 0
# and
test -r /etc/httpd/conf/httpd.conf || return 0
```
Add this shell script to your crontab (or copy it to `/etc/cron.daily/`) to be notified via email when your certificates reach expiry.
The default behavior (without arguments) is to notify the root user, once the certificates will expire in 30 days or less.
## Usage
All command line arguments are optional and if not specified, the default values are used.
```shell
$ nginx-certwatch [--period=30] [[email protected]] [--path=/etc/nginx]
--period=XX specify period in days to check for (Default: 30)
--email=root specify email to send notifications if period expires (Default: root)
--path=/etc/path specify nginx config base path (Default: /etc/nginx)
```
## Cronjob
Put the following example in your cron daily and replace the email with your own.
```shell
@daily /path/to/nginx-certwatch [email protected]
```
or
```shell
0 0 * * * /path/to/nginx-certwatch [email protected]
```
## Note
* 100% POSIX compatible
* No [bashism](http://mywiki.wooledge.org/Bashism)