{"id":13587431,"url":"https://github.com/bluet/docker-cronicle-docker","last_synced_at":"2026-02-14T16:35:09.556Z","repository":{"id":40306486,"uuid":"233347195","full_name":"bluet/docker-cronicle-docker","owner":"bluet","description":"Scheduling dockerized Cronicle cron jobs run in docker container.","archived":false,"fork":false,"pushed_at":"2025-11-01T19:34:01.000Z","size":73,"stargazers_count":135,"open_issues_count":6,"forks_count":31,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-11-01T20:31:26.216Z","etag":null,"topics":["cron","cronicle","cronjob","crontab","docker-container","docker-jobs","fossa-status","hacktoberfest","scheduler"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/bluet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["bluet"],"patreon":null,"open_collective":null,"ko_fi":"bluet","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2020-01-12T06:11:48.000Z","updated_at":"2025-11-01T19:34:05.000Z","dependencies_parsed_at":"2023-12-05T19:41:43.792Z","dependency_job_id":null,"html_url":"https://github.com/bluet/docker-cronicle-docker","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/bluet/docker-cronicle-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluet%2Fdocker-cronicle-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluet%2Fdocker-cronicle-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluet%2Fdocker-cronicle-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluet%2Fdocker-cronicle-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bluet","download_url":"https://codeload.github.com/bluet/docker-cronicle-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluet%2Fdocker-cronicle-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29449374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T15:52:44.973Z","status":"ssl_error","status_checked_at":"2026-02-14T15:52:11.208Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cron","cronicle","cronjob","crontab","docker-container","docker-jobs","fossa-status","hacktoberfest","scheduler"],"created_at":"2024-08-01T15:06:12.619Z","updated_at":"2026-02-14T16:35:09.542Z","avatar_url":"https://github.com/bluet.png","language":"Shell","funding_links":["https://github.com/sponsors/bluet","https://ko-fi.com/bluet"],"categories":["Shell"],"sub_categories":[],"readme":"# docker-cronicle-docker\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n[![Docker Pulls](https://img.shields.io/docker/pulls/bluet/cronicle-docker.svg)](https://shields.io/)\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fbluet%2Fdocker-cronicle-docker.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fbluet%2Fdocker-cronicle-docker?ref=badge_shield)\n\nWorkflow scheduler to run docker jobs just like cron,  \nand *each job runs inside **its own containers***,  \nwith Cronicle in docker.\n\nRun dockerized Cronicle (corn) jobs in docker container.  \nOr just *run a **prebuilt docker image*** as your task/job.\n\n- GitHub: https://github.com/bluet/docker-cronicle-docker\n- Docker Hub: https://hub.docker.com/r/bluet/cronicle-docker\n\n# Supported tags\n\n* [Tags](https://hub.docker.com/r/bluet/cronicle-docker/tags) \n* [Dockerfile](https://raw.githubusercontent.com/bluet/docker-cronicle-docker/master/docker/Dockerfile)\n\n# Usage\n\n## Install\n```sh\ndocker pull bluet/cronicle-docker:latest\n```\n\n## Running\n```sh\ndocker run -v /var/run/docker.sock:/var/run/docker.sock --hostname localhost -p 3012:3012 --name cronicle bluet/cronicle-docker:latest\n```\n\nAlternatively with persistent data and logs:\n```sh\ndocker run \\\n        -v /var/run/docker.sock:/var/run/docker.sock:rw \\\n        -v $PWD/data:/opt/cronicle/data:rw \\\n        -v $PWD/logs:/opt/cronicle/logs:rw \\\n        -v $PWD/plugins:/opt/cronicle/plugins:rw \\\n        -v $PWD/app:/app:rw \\\n        --hostname localhost \\\n        -p 3012:3012\\\n        --name cronicle \\\n        bluet/cronicle-docker:latest\n```\n\nThe web UI will be available at: http://localhost:3012\n\n\u003e NOTE: please replace the hostname `localhost`, this is only for testing\n\u003e purposes! If you rename the hostname also consider setting the environmental\n\u003e variable `CRONICLE_base_app_url`.\n\u003e e.g `docker run --name cronicle --hostname cronicle-host -p 3012:3012 -e CRONICLE_base_app_url='http://cronicle-host:3012' bluet/cronicle-docker:latest`\n\n## Volumes\n\n| Path | Description |\n|--------|--------|\n| /opt/cronicle/data | Volume for data |\n| /opt/cronicle/logs | Volume for logs |\n| /opt/cronicle/plugins | Volume for plugins |\n| /app | Volume for additional files if needed by jobs |\n\n## Configuration\n\n### Environmental variables\nCronicle supports a special environment variable syntax, which can specify command-line options as well as override any configuration settings.  The variable name syntax is `CRONICLE_key` where `key` is one of several command-line options (see table below) or a JSON configuration property path.\n\nFor a list of latest default values, please check [Official documment](https://github.com/jhuckaby/Cronicle/blob/master/docs/Configuration.md).\n\nFor overriding configuration properties by environment variable, you can specify any top-level JSON key from `config.json`, or a *path* to a nested property using double-underscore (`__`) as a path separator.  For boolean properties, you can specify `1` for true and `0` for false.  Here is an example of some of the possibilities available:\n\n| Environmental variable | Description | Default value |\n|--------|--------|--------|\n| CRONICLE_base_app_url | A fully-qualified URL to Cronicle on your server, including the port if non-standard. This is used for self-referencing URLs. | http://localhost:3012 |\n| CRONICLE_WebServer__http_port | The HTTP port for the web UI of your Cronicle server. (Keep default value, unless you know what you are doing) | 3012 |\n| CRONICLE_WebServer__https_port | The SSL port for the web UI of your Cronicle server. (Keep default value, unless you know what you are doing) | 443 |\n| CRONICLE_web_socket_use_hostnames | Setting this parameter to `1` will force Cronicle's Web UI to connect to the back-end servers using their hostnames rather than IP addresses. This includes both AJAX API calls and Websocket streams. | 0 |\n| CRONICLE_server_comm_use_hostnames | Setting this parameter to `1` will force the Cronicle servers to connect to each other using hostnames rather than LAN IP addresses. | 0 |\n| CRONICLE_web_direct_connect | When this property is set to `0`, the Cronicle Web UI will connect to whatever hostname/port is on the URL. It is expected that this hostname/port will always resolve to your master server. This is useful for single server setups, situations when your users do not have direct access to your Cronicle servers via their IPs or hostnames, or if you are running behind some kind of reverse proxy. If you set this parameter to `1`, then the Cronicle web application will connect directly to your individual Cronicle servers. This is more for multi-server configurations, especially when running behind a load balancer with multiple backup servers. The Web UI must always connect to the master server, so if you have multiple backup servers, it needs a direct connection. | 0 |\n| CRONICLE_socket_io_transports | This allows you to customize the socket.io transports used to connect to the server for real-time updates. If you are trying to run Cronicle in an environment where WebSockets are not allowed (perhaps an ancient firewall or proxy), you can change this array to contain the `polling` transport first. Otherwise set it to `[\"websocket\"]` | [\"websocket\"] |\n\n### Custom configuration file\nA custom configuration file can be provide in the following location:\n```sh\n/path-to-cronicle-storage/data/config.json.import\n```\nThe file will get loaded the very first time Cronicle is started. If afterwards\na forced reload of the custom configuration is needed remove the following file\nand restart the Docker container:\n```sh\n/path-to-cronicle-storage/data/.setup_done\n```\n\n## Web UI credentials\nThe default credentials for the web interface are: `admin` / `admin`\n\n\n\n# Reference\n- Docker Hub: https://hub.docker.com/r/bluet/cronicle-docker\n- https://github.com/jhuckaby/Cronicle\n- https://github.com/belsander/docker-cronicle\n\n## License\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fbluet%2Fdocker-cronicle-docker.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fbluet%2Fdocker-cronicle-docker?ref=badge_large)\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://www.winstonspencer.com/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/3476702?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eWinston Spencer\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/bluet/docker-cronicle-docker/commits?author=winstonspencer\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://moshegrunwald.com\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/34072688?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMoshe Grunwald\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/bluet/docker-cronicle-docker/commits?author=TheBestMoshe\" title=\"Code\"\u003e💻\u003c/a\u003e \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluet%2Fdocker-cronicle-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbluet%2Fdocker-cronicle-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluet%2Fdocker-cronicle-docker/lists"}