{"id":21657250,"url":"https://github.com/zcubbs/ssl-tracker","last_synced_at":"2026-04-12T09:02:32.206Z","repository":{"id":250858994,"uuid":"666617132","full_name":"zcubbs/ssl-tracker","owner":"zcubbs","description":"🔒 SSL Tracker is designed to monitor the status and health of SSL/TLS certificates. In today's digital world, ensuring the validity and security of your SSL/TLS certificates is crucial. With our application, you can streamline this process, keeping an eye on your certificates.","archived":false,"fork":false,"pushed_at":"2023-10-24T23:32:56.000Z","size":3333,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-11T11:48:30.581Z","etag":null,"topics":["certificate-checker","dashboard","notifications","scheduler","ssl","tls"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/zcubbs.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":"2023-07-15T02:35:55.000Z","updated_at":"2024-07-30T09:31:08.000Z","dependencies_parsed_at":"2024-07-30T13:56:54.150Z","dependency_job_id":null,"html_url":"https://github.com/zcubbs/ssl-tracker","commit_stats":null,"previous_names":["zcubbs/ssl-tracker"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcubbs%2Fssl-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcubbs%2Fssl-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcubbs%2Fssl-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcubbs%2Fssl-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zcubbs","download_url":"https://codeload.github.com/zcubbs/ssl-tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244554120,"owners_count":20471173,"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-checker","dashboard","notifications","scheduler","ssl","tls"],"created_at":"2024-11-25T09:20:11.910Z","updated_at":"2026-04-12T09:02:32.122Z","avatar_url":"https://github.com/zcubbs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SSL Tracker\n\n[![tag](https://img.shields.io/github/tag/zcubbs/tlz)](https://github.com/zcubbs/ssl-tracker/releases)\n![Go Version](https://img.shields.io/badge/Go-%3E%3D%201.21-%23007d9c)\n[![Lint](https://github.com/zcubbs/ssl-tracker/actions/workflows/lint.yaml/badge.svg)](https://github.com/zcubbs/ssl-tracker/actions/workflows/lint.yaml)\n[![Test](https://github.com/zcubbs/ssl-tracker/actions/workflows/test.yaml/badge.svg)](https://github.com/zcubbs/ssl-tracker/actions/workflows/test.yaml)\n[![release](https://github.com/zcubbs/ssl-tracker/actions/workflows/release.yaml/badge.svg)](https://github.com/zcubbs/ssl-tracker/actions/workflows/release.yaml)\n[![scan](https://github.com/zcubbs/ssl-tracker/actions/workflows/scan.yaml/badge.svg)](https://github.com/zcubbs/ssl-tracker/actions/workflows/scan.yaml)\n[![Contributors](https://img.shields.io/github/contributors/zcubbs/go-containers)](https://github.com/zcubbs/ssl-tracker/graphs/contributors)\n\nThis application is designed to monitor the status and health of SSL/TLS certificates. In today's digital world, ensuring the validity and security of your SSL/TLS certificates is crucial. With our application, you can streamline this process, keeping an eye on your certificates and their expiry dates.\n\n**SSL Tracker** does more than just monitor - it actively notifies you of any pending expiry dates, ensuring you have ample time to renew and prevent any potential downtime or security issues. By proactively managing your SSL/TLS certificates, our application helps maintain the integrity and reliability of your digital infrastructure.\n\nWhether you are managing a single website or a vast network, this application is designed to be your reliable companion in maintaining your SSL/TLS certificate health.\n\n## CRON Jobs\n\n### Cron job configuration\n\n### About Patterns\n\nEach job can be configured with a cron pattern. The pattern is a string of 5 or 6 fields separated by white space that\nrepresents a set of times, normally as a schedule to execute some routine. The fields are as follows:\n\n```\n*    *    *    *    *    *\n-    -    -    -    -    -\n|    |    |    |    |    |\n|    |    |    |    |    + year [optional]\n|    |    |    |    +----- day of week (0 - 7) (Sunday=0 or 7)\n|    |    |    +---------- month (1 - 12)\n|    |    +--------------- day of month (1 - 31)\n|    +-------------------- hour (0 - 23)\n+------------------------- min (0 - 59)\n```\n\n\u003e You can choose to run a job only once by passing \"-\" as the cron pattern.\n\u003e Exemple: `CRON_CHECK_CERTIFICATE_VALIDITY_CRON_PATTERN=-`\n\n## Database Support\n\nThis application supports both **PostgreSQL** and **SQLite** databases, adapting to various use cases and deployment scenarios.\n\n### PostgreSQL\n\nPostgreSQL is a powerful, open-source object-relational database system. To configure the application for PostgreSQL, set `database.postgres.enabled` to `true` and provide the necessary connection details.\n\n### SQLite\n\nSQLite is a self-contained, serverless, zero-configuration SQL database engine, ideal for simpler setup requirements. To configure the application for SQLite, set `database.sqlite.enabled` to `true` and provide the necessary connection details.\n\n\n## Configuration\n\n### Environment Variables Configuration Documentation\n\n| Environment Variable                           | Description                                 | Default Value                  |\n|------------------------------------------------|---------------------------------------------|--------------------------------|\n| `DEBUG`                                        | Application debug mode                      | `false`                        |\n| `HTTP_SERVER_PORT`                             | HTTP server port                            | `8000`                         |\n| `HTTP_SERVER_ALLOW_ORIGINS`                    | Allowed origins for CORS                    | `*`                            |\n| `HTTP_SERVER_ALLOW_HEADERS`                    | Allowed headers for CORS                    | `Origin, Content-Type, Accept` |\n| `HTTP_SERVER_TZ`                               | Time zone for the HTTP server               | `UTC`                          |\n| `HTTP_SERVER_ENABLE_PRINT_ROUTES`              | Enable route printing                       | `false`                        |\n| `DATABASE_POSTGRES_ENABLED`                    | Enable Postgres database                    | `false`                        |\n| `DATABASE_POSTGRES_HOST`                       | Postgres host                               | `\"\"`                           |\n| `DATABASE_POSTGRES_PORT`                       | Postgres port                               | `\"\"`                           |\n| `DATABASE_POSTGRES_USERNAME`                   | Postgres username                           | `\"\"`                           |\n| `DATABASE_POSTGRES_PASSWORD`                   | Postgres password                           | `\"\"`                           |\n| `DATABASE_POSTGRES_DATABASE`                   | Postgres database name                      | `\"\"`                           |\n| `DATABASE_POSTGRES_SSL_MODE`                   | SSL mode for Postgres                       | `\"\"`                           |\n| `DATABASE_POSTGRES_VERBOSE`                    | Verbose mode for Postgres                   | `\"\"`                           |\n| `DATABASE_SQLITE_ENABLED`                      | Enable SQLite database                      | `true`                         |\n| `DATABASE_SQLITE_DB_NAME`                      | SQLite database name                        | `\"DefaultDbName\"`              |\n| `CRON_CHECK_CERTIFICATE_VALIDITY_ENABLED`      | Enable certificate validity check cron job  | `true`                         |\n| `CRON_CHECK_CERTIFICATE_VALIDITY_CRON_PATTERN` | Cron pattern for certificate validity check | `\"*/10 * * * * *\"`             |\n| `CRON_SEND_MAIL_NOTIFICATION_ENABLED`          | Enable mail notification cron job           | `true`                         |\n| `CRON_SEND_MAIL_NOTIFICATION_CRON_PATTERN`     | Cron pattern for mail notification          | `\"*/10 * * * * *\"`             |\n| `NOTIFICATION_MAIL_SMTP_ENABLED`               | Enable SMTP for mail notification           | `true`                         |\n| `NOTIFICATION_MAIL_SMTP_HOST`                  | SMTP host for mail notification             | `\"localhost\"`                  |\n| `NOTIFICATION_MAIL_SMTP_PORT`                  | SMTP port for mail notification             | `1025`                         |\n| `NOTIFICATION_MAIL_SMTP_USERNAME`              | SMTP username for mail notification         | `\"\"`                           |\n| `NOTIFICATION_MAIL_SMTP_PASSWORD`              | SMTP password for mail notification         | `\"\"`                           |\n| `NOTIFICATION_MAIL_SMTP_FROM`                  | SMTP from address for mail notification     | `\"no-reply@ssl-tracker\"`       |\n\n### YAML Configuration Documentation\n\n| YAML Path                                      | Description                                 | Default Value                  |\n|------------------------------------------------|---------------------------------------------|--------------------------------|\n| `debug`                                        | Application debug mode                      | `false`                        |\n| `http_server.port`                             | HTTP server port                            | `8000`                         |\n| `http_server.allow_origins`                    | Allowed origins for CORS                    | `*`                            |\n| `http_server.allow_headers`                    | Allowed headers for CORS                    | `Origin, Content-Type, Accept` |\n| `http_server.tz`                               | Time zone for the HTTP server               | `UTC`                          |\n| `http_server.enable_print_routes`              | Enable route printing                       | `false`                        |\n| `database.postgres.enabled`                    | Enable Postgres database                    | `false`                        |\n| `database.postgres.host`                       | Postgres host                               | `\"\"`                           |\n| `database.postgres.port`                       | Postgres port                               | `\"\"`                           |\n| `database.postgres.username`                   | Postgres username                           | `\"\"`                           |\n| `database.postgres.password`                   | Postgres password                           | `\"\"`                           |\n| `database.postgres.database`                   | Postgres database name                      | `\"\"`                           |\n| `database.postgres.ssl_mode`                   | SSL mode for Postgres                       | `\"\"`                           |\n| `database.postgres.verbose`                    | Verbose mode for Postgres                   | `\"\"`                           |\n| `database.sqlite.enabled`                      | Enable SQLite database                      | `true`                         |\n| `database.sqlite.db_name`                      | SQLite database name                        | `\"DefaultDbName\"`              |\n| `cron.check_certificate_validity.enabled`      | Enable certificate validity check cron job  | `true`                         |\n| `cron.check_certificate_validity.cron_pattern` | Cron pattern for certificate validity check | `\"*/10 * * * * *\"`             |\n| `cron.send_mail_notification.enabled`          | Enable mail notification cron job           | `true`                         |\n| `cron.send_mail_notification.cron_pattern`     | Cron pattern for mail notification          | `\"*/10 * * * * *\"`             |\n| `notification.mail.smtp.enabled`               | Enable SMTP for mail notification           | `true`                         |\n| `notification.mail.smtp.host`                  | SMTP host for mail notification             | `\"localhost\"`                  |\n| `notification.mail.smtp.port`                  | SMTP port for mail notification             | `1025`                         |\n| `notification.mail.smtp.username`              | SMTP username for mail notification         | `\"\"`                           |\n| `notification.mail.smtp.password`              | SMTP password for mail notification         | `\"\"`                           |\n| `notification.mail.smtp.from`                  | SMTP from address for mail notification     | `\"no-reply@ssl-tracker\"`       |\n\n## Development\n\n### Prerequisites\n\n- [Go](https://golang.org/doc/install) (version 1.20 or higher)\n- [Task](https://taskfile.dev/#/installation)\n- [Docker](https://docs.docker.com/get-docker/) \n- Windows:\n  - [Scoop](https://scoop.sh/) \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzcubbs%2Fssl-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzcubbs%2Fssl-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzcubbs%2Fssl-tracker/lists"}