{"id":22540678,"url":"https://github.com/yegor-usoltsev/drone-email-webhook","last_synced_at":"2025-07-29T07:40:25.359Z","repository":{"id":170466867,"uuid":"646383518","full_name":"yegor-usoltsev/drone-email-webhook","owner":"yegor-usoltsev","description":"Webhook listener for Drone CI / CD notifying commit authors of failed builds via email","archived":false,"fork":false,"pushed_at":"2025-07-05T22:38:44.000Z","size":311,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-05T23:24:44.562Z","etag":null,"topics":["build-automation","ci","devops","drone","drone-ci","drone-plugin","email","mail","smtp","webhook"],"latest_commit_sha":null,"homepage":"","language":"Go","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/yegor-usoltsev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2023-05-28T08:09:39.000Z","updated_at":"2025-07-05T22:38:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"8d7c7ada-789f-443a-9a2e-1c6820e1ec24","html_url":"https://github.com/yegor-usoltsev/drone-email-webhook","commit_stats":null,"previous_names":["yegor-usoltsev/drone-email-webhook"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/yegor-usoltsev/drone-email-webhook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yegor-usoltsev%2Fdrone-email-webhook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yegor-usoltsev%2Fdrone-email-webhook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yegor-usoltsev%2Fdrone-email-webhook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yegor-usoltsev%2Fdrone-email-webhook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yegor-usoltsev","download_url":"https://codeload.github.com/yegor-usoltsev/drone-email-webhook/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yegor-usoltsev%2Fdrone-email-webhook/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267648080,"owners_count":24121417,"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","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["build-automation","ci","devops","drone","drone-ci","drone-plugin","email","mail","smtp","webhook"],"created_at":"2024-12-07T12:12:02.037Z","updated_at":"2025-07-29T07:40:25.351Z","avatar_url":"https://github.com/yegor-usoltsev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# drone-email-webhook\n\n[![Build Status](https://github.com/yegor-usoltsev/drone-email-webhook/actions/workflows/ci.yml/badge.svg)](https://github.com/yegor-usoltsev/drone-email-webhook/actions)\n[![Codecov](https://codecov.io/github/yegor-usoltsev/drone-email-webhook/graph/badge.svg?token=Z1GET86OND)](https://codecov.io/github/yegor-usoltsev/drone-email-webhook)\n[![GitHub Release](https://img.shields.io/github/v/release/yegor-usoltsev/drone-email-webhook?sort=semver)](https://github.com/yegor-usoltsev/drone-email-webhook/releases)\n[![Docker Image (docker.io)](https://img.shields.io/docker/v/yusoltsev/drone-email-webhook?label=docker.io\u0026sort=semver)](https://hub.docker.com/r/yusoltsev/drone-email-webhook)\n[![Docker Image (ghcr.io)](https://img.shields.io/docker/v/yusoltsev/drone-email-webhook?label=ghcr.io\u0026sort=semver)](https://github.com/yegor-usoltsev/drone-email-webhook/pkgs/container/drone-email-webhook)\n[![Docker Image Size](https://img.shields.io/docker/image-size/yusoltsev/drone-email-webhook?sort=semver\u0026arch=amd64)](https://hub.docker.com/r/yusoltsev/drone-email-webhook/tags)\n\nWebhook listener for Drone CI / CD notifying commit authors of failed builds via email.\n\n| ![Light Screenshot](https://raw.githubusercontent.com/yegor-usoltsev/drone-email-webhook/main/.github/light.png) | ![Dark Screenshot](https://raw.githubusercontent.com/yegor-usoltsev/drone-email-webhook/main/.github/dark.png) |\n| :--------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------: |\n\n## Usage\n\n### Starting the webhook listener\n\nPull and run the container:\n\n```bash\ndocker run -d \\\n  -p 3000:3000 \\\n  -e DRONE_SECRET=your_webhook_secret \\\n  yusoltsev/drone-email-webhook:latest\n```\n\nSee the [Environment Variables](#environment-variables) table below for all available configuration options.\n\n### Configuring Drone\n\nConfigure your Drone server to send webhooks by setting the following environment variables:\n\n```yaml\nDRONE_WEBHOOK_ENDPOINT: http://your-webhook-host:3000\nDRONE_WEBHOOK_SECRET: your_webhook_secret # Must match DRONE_SECRET in webhook container\n```\n\nFor more information about Drone webhooks configuration, please refer to\nthe [official Drone documentation](https://docs.drone.io/webhooks/overview/).\n\nNote: Make sure to replace the placeholder values with your actual configuration values.\n\n### Environment Variables\n\n| KEY                         | TYPE                         | DEFAULT           | REQUIRED |\n| --------------------------- | ---------------------------- | ----------------- | -------- |\n| `DRONE_SECRET`              | `string`                     |                   | Yes      |\n| `DRONE_SERVER_HOST`         | `string`                     | `0.0.0.0`         | Yes      |\n| `DRONE_SERVER_PORT`         | `uint16`                     | `3000`            | Yes      |\n| `DRONE_EMAIL_SMTP_HOST`     | `string`                     | `localhost`       | Yes      |\n| `DRONE_EMAIL_SMTP_PORT`     | `uint16`                     | `25`              | Yes      |\n| `DRONE_EMAIL_SMTP_USERNAME` | `string`                     |                   | No       |\n| `DRONE_EMAIL_SMTP_PASSWORD` | `string`                     |                   | No       |\n| `DRONE_EMAIL_FROM`          | `string`                     | `drone@localhost` | Yes      |\n| `DRONE_EMAIL_CC`            | `[]string` (comma-separated) |                   | No       |\n| `DRONE_EMAIL_BCC`           | `[]string` (comma-separated) |                   | No       |\n\n## Docker Images\n\nThis application is delivered as a multi-platform Docker image and is available for download from two image registries\nof choice: [yusoltsev/drone-email-webhook](https://hub.docker.com/r/yusoltsev/drone-email-webhook)\nand [ghcr.io/yegor-usoltsev/drone-email-webhook](https://github.com/yegor-usoltsev/drone-email-webhook/pkgs/container/drone-email-webhook).\n\n## Versioning\n\nThis project uses [Semantic Versioning](https://semver.org)\n\n## Contributing\n\nPull requests are welcome. For major changes,\nplease [open an issue](https://github.com/yegor-usoltsev/drone-email-webhook/issues/new) first to discuss what you would\nlike to change. Please make sure to update tests as appropriate.\n\n## License\n\n[MIT](https://github.com/yegor-usoltsev/drone-email-webhook/blob/main/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyegor-usoltsev%2Fdrone-email-webhook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyegor-usoltsev%2Fdrone-email-webhook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyegor-usoltsev%2Fdrone-email-webhook/lists"}