{"id":13504394,"url":"https://github.com/distribworks/dkron","last_synced_at":"2026-01-12T02:42:26.248Z","repository":{"id":33538100,"uuid":"37184230","full_name":"distribworks/dkron","owner":"distribworks","description":"Dkron - Distributed, fault tolerant job scheduling system https://dkron.io","archived":false,"fork":false,"pushed_at":"2025-04-08T09:39:17.000Z","size":133858,"stargazers_count":4443,"open_issues_count":93,"forks_count":393,"subscribers_count":94,"default_branch":"main","last_synced_at":"2025-04-13T02:03:16.472Z","etag":null,"topics":["cron","distributed-systems","fault-tolerance","scheduled-jobs"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/distribworks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2015-06-10T08:13:17.000Z","updated_at":"2025-04-11T18:36:10.000Z","dependencies_parsed_at":"2023-07-13T11:18:17.493Z","dependency_job_id":"7fdc4aea-6039-4d32-80cb-a3908f2688a8","html_url":"https://github.com/distribworks/dkron","commit_stats":{"total_commits":2174,"total_committers":85,"mean_commits":"25.576470588235296","dds":"0.21987120515179392","last_synced_commit":"8c94a5d92fa7c2676f49fc7eb97f3ff6f660b471"},"previous_names":["victorcoder/dcron","victorcoder/dkron"],"tags_count":133,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/distribworks%2Fdkron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/distribworks%2Fdkron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/distribworks%2Fdkron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/distribworks%2Fdkron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/distribworks","download_url":"https://codeload.github.com/distribworks/dkron/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250514211,"owners_count":21443205,"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":["cron","distributed-systems","fault-tolerance","scheduled-jobs"],"created_at":"2024-08-01T00:00:36.598Z","updated_at":"2026-01-12T02:42:26.241Z","avatar_url":"https://github.com/distribworks.png","language":"Go","readme":"\u003cp align=\"center\"\u003e\n\u003cimg width=\"400\" src=\"docs/images/DKRON_STICKER_OK_CMYK_RGB_CONV_300.png\" alt=\"Dkron\" title=\"Dkron\" /\u003e\n\u003c/p\u003e\n\n# Dkron - Distributed, fault tolerant job scheduling system for cloud native environments [![GoDoc](https://godoc.org/github.com/distribworks/dkron?status.svg)](https://godoc.org/github.com/distribworks/dkron) [![Actions Status](https://github.com/distribworks/dkron/workflows/Test/badge.svg)](https://github.com/distribworks/dkron/actions) [![Gitter](https://badges.gitter.im/distribworks/dkron.svg)](https://gitter.im/distribworks/dkron) [![Gurubase](https://img.shields.io/badge/Gurubase-Ask%20Dkron%20Guru-006BFF)](https://gurubase.io/g/dkron)\n\nWebsite: http://dkron.io/\n\nDkron is a distributed cron service, easy to setup and fault tolerant with focus in:\n\n- Easy: Easy to use with a great UI\n- Reliable: Completely fault tolerant\n- Highly scalable: Able to handle high volumes of scheduled jobs and thousands of nodes\n\nDkron is written in Go and leverage the power of the Raft protocol and Serf for providing fault tolerance, reliability\nand scalability while keeping simple and easily installable.\n\nDkron is inspired by the google\nwhitepaper [Reliable Cron across the Planet](https://queue.acm.org/detail.cfm?id=2745840) and by Airbnb Chronos\nborrowing the same features from it.\n\nDkron runs on Linux, OSX and Windows. It can be used to run scheduled commands on a server cluster using any combination\nof servers for each job. It has no single points of failure due to the use of the Gossip protocol and fault tolerant\ndistributed databases.\n\nYou can use Dkron to run the most important part of your company, scheduled jobs.\n\n## Installation\n\n[Installation instructions](https://dkron.io/docs/basics/installation)\n\nFull, comprehensive documentation is accessible on the [Dkron website](http://dkron.io)\n\n## Quickstart\n\n### Deploying Dkron using Docker\n\nThe best way to test and develop dkron is using docker, you will need [Docker](https://www.docker.com/) with Docker\ncompose installed before proceeding.\n\n```bash\ndocker compose up -d\n```\n\nThe UI should be available on http://localhost:8080/ui.\n\n### Using Dkron\n\nTo add jobs to the system read the [API docs](https://dkron.io/api/).\n\n### Scaling the cluster\n\nTo add more Dkron instances to the cluster:\n\n```bash\ndocker compose up -d --scale dkron-server=4\ndocker compose up -d --scale dkron-agent=10\n```\n\n## Development\n\nTo develop Dkron, you can deploy the cluster with local changes applied with the following steps:\n\n1. Clone the repository.\n\n2. Run the `docker compose`:\n\n    ```bash\n    docker compose -f docker-compose.dev.yml up\n    ```\n\n### Email Testing\n\nFor testing email notifications during development, Mailpit is included in the development docker-compose setup. Mailpit provides a local SMTP server that captures outgoing emails without sending them to real recipients.\n\nStart Mailpit with the development environment:\n\n```bash\ndocker compose -f docker-compose.dev.yml up mailpit\n```\n\nOr run it standalone:\n\n```bash\ndocker run -p 8025:8025 -p 1025:1025 axllent/mailpit\n```\n\nView captured emails at: http://localhost:8025\n\nFor more information, see [docs/EMAIL_TESTING.md](docs/EMAIL_TESTING.md).\n\n### Testing CI Locally\n\nTo validate that your changes will pass in GitHub Actions before pushing:\n\n```bash\n./scripts/test-ci-locally.sh\n```\n\nThis script:\n- Starts Mailpit (simulating the CI service container)\n- Runs tests with the same configuration as GitHub Actions\n- Provides clear pass/fail results\n- Allows you to inspect emails in the Mailpit UI\n\nSee [.github/TESTING.md](.github/TESTING.md) for more information about CI testing.\n\n### Frontend development\n\nDkron dashboard is built using [React Admin](https://marmelab.com/react-admin/) as a single page application.\n\nTo start developing the dashboard enter the `ui` directory and run `npm install` to get the frontend dependencies and\nthen start the local server with `npm start` it should start a new local web server and open a new browser window\nserving de web ui.\n\nMake your changes to the code, then run `make ui` to generate assets files. This is a method of embedding resources in\nGo applications.\n\n### Resources\n\nChef cookbook\nhttps://supermarket.chef.io/cookbooks/dkron\n\nPython Client Library\nhttps://github.com/oldmantaiter/pydkron\n\nRuby client\nhttps://github.com/jobandtalent/dkron-rb\n\nPHP client\nhttps://github.com/gromo/dkron-php-adapter\n\nTerraform provider\nhttps://github.com/bozerkins/terraform-provider-dkron\n\nManage and run jobs in Dkron from your django project\nhttps://github.com/surface-security/django-dkron\n\n## Contributors\n\n\u003ca href=\"https://github.com/distribworks/dkron/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=distribworks/dkron\" /\u003e\n\u003c/a\u003e\n\nMade with [contrib.rocks](https://contrib.rocks).\n\n## Get in touch\n\n- Twitter: [@distribworks](https://twitter.com/distribworks)\n- Chat: https://gitter.im/distribworks/dkron\n- Email: victor at distrib.works\n\n","funding_links":[],"categories":["Misc","Distributed Messaging","开源类库","Cron Job","Schedulers","Go","Open source library","distributed-systems"],"sub_categories":["任务/定时器","IRC","Vectors","Task/Timer"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdistribworks%2Fdkron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdistribworks%2Fdkron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdistribworks%2Fdkron/lists"}