🗓️ Expiration-check is a command-line tool designed to verify the expiration dates of domains and TLS certificates.
  • Go 70.6%
  • Makefile 21.6%
  • Shell 7.8%
Find a file
Simon Vieille b27f7773ca
All checks were successful
ci/woodpecker/push/test Pipeline was successful
ci/woodpecker/push/build Pipeline was successful
ci/woodpecker/tag/test Pipeline was successful
ci/woodpecker/tag/build Pipeline was successful
fix typo in CI
2025-02-24 15:11:04 +01:00
.woodpecker fix typo in CI 2025-02-24 15:11:04 +01:00
bin add set -e option in shell scripts 2024-07-29 12:19:44 +02:00
checker add logger 2025-02-24 15:07:37 +01:00
logger add logger 2025-02-24 15:07:28 +01:00
render fix: render days and date when the value is later than danger value 2025-02-24 15:08:33 +01:00
.fpm add debian packaging 2024-07-24 11:38:33 +02:00
.gitignore apply linter 2024-07-22 11:36:24 +02:00
app.go add logger 2025-02-24 15:07:37 +01:00
CHANGELOG.md update changelog 2025-02-24 15:09:22 +01:00
go.mod add whois as RDAP fallback 2024-07-22 14:32:50 +02:00
go.sum add whois as RDAP fallback 2024-07-22 14:32:50 +02:00
LICENCE add the licence 2024-07-24 11:38:40 +02:00
main.go init 2024-07-22 10:36:51 +02:00
Makefile add manpage builder 2024-07-29 12:11:06 +02:00
README.md update readme 2024-07-24 17:21:29 +02:00

🗓️ Expiration check

Expiration-check is a command-line tool designed to verify the expiration dates of domains and TLS certificates.

For domain verification, it implements the RDAP protocol whenever possible. If RDAP is unavailable, it falls back on the WHOIS protocol.

📗 How to install the project

Pre-compiled versions are available in the Releases. Multiple operating systems are supported, including Linux, Windows, and macOS. For Debian users, a package is also provided.

If you want to compile the project from source, you will need at least the GO compiler version 1.22. Clone the project and run the make command. The compiled output will be located in the build directory.

$ git clone https://gitnet.fr/deblan/expiration-check
$ make

🧪 How to use the project

Commands

  • certificates, certificate, cert, certs, c: Checks the expiration dates of TLS certificates.
  • domains, domain, d: Checks the expiration dates of domain names.
  • help, h: Displays a list of all commands or detailed help for a specific command.

Global Options

  • --help, -h: Shows the help message, providing information about the usage and available commands.

Use the --format or -f option to specify the output format. Available formats are table, csv, tsv, html, json, and markdown. The default format is table.

Examples

Check certificate expirations:

expiration-check certificate --domain example.com

Check domain expirations:

expiration-check domain --domain example.com

Check certificates for multiple domains with default table format:

expiration-check certificate --domain example.com --domain example.org

Check certificates and output results in JSON format:

expiration-check certificate --domain example.com --format json

Get help for a specific command:

expiration-check help certificate