Support

How can we help?

A person reads every message and replies within two business days, usually much sooner.

To help us answer faster, include your GitHub account or organization, the repository and workflow file, and the time of the run (with time zone).

Frequently asked questions

My workflow didn’t run. What do I check?
Open your dashboard. A workflow marked Needs a fix names the problem, such as a leftover schedule: or a missing workflow_dispatch:. For a single run, open the workflow and click the run: it shows every step from the scheduled time to the job’s result. See Statuses.
How fast does Cronkick start a run?
Cronkick aims to send it within 30 seconds of the scheduled time. Runs due on the hour are spread over up to 15 seconds. After that, GitHub queues the job for a runner, which your dashboard shows separately. See Timing and retries.
Can a workflow run twice?
Cronkick retries only when GitHub answers with an error. If it can’t tell whether GitHub got a request, it doesn’t resend it and marks the run Unconfirmed. A workflow with a leftover schedule: block would also run on GitHub’s schedule, so Cronkick marks it Needs a fix and doesn’t send it.
What happens when GitHub is down?
Cronkick retries until 5 minutes after the scheduled time (or the next run, if sooner), then marks the run Gave up rather than start it late. If GitHub refuses the request outright, the run shows Refused with GitHub’s reason, and Cronkick doesn’t retry it.
Do I need a personal access token?
No. Cronkick is a GitHub App and uses short-lived tokens limited to the repositories you choose.
Can Cronkick read my code?
It can. The Contents read permission lets the app read any file in the repositories you select. Cronkick reads workflow files in .github/workflows to find markers. It stores the marker lines it reads and compatibility warnings (such as a YAML parser’s error message with its line number), not your code, the files themselves or workflow logs. See Permissions and security.
Does it work with organizations, private repositories and time zones?
Yes. Install the app on a personal account or an organization, public or private repositories. Add tz=Europe/Berlin (any IANA time zone) to a marker. See The marker.
What are the limits on the Free plan?
Unlimited repositories, 3 schedules, every 15 minutes or slower, 7 days of history. See Plans and limits.
How do I upgrade, cancel or get a refund?
Upgrade from Settings in your dashboard: personal accounts get Pro ($5/month), organizations get Team ($19/month). Cancel any time from Manage billing in Settings; the plan runs until the end of the period you paid for. Any charge is fully refundable within 14 days: email [email protected], and see the refund policy.
How do I stop Cronkick?
Remove a marker line to stop one schedule, or uninstall the GitHub App in your GitHub settings to stop everything at once. To hand a workflow back to GitHub’s scheduler, see Go back to GitHub’s scheduler.