Skip to content
Latchkey

How to Schedule Renovate Runs With a Timezone

The schedule field restricts when Renovate raises or updates PRs, and timezone anchors those windows to your local time instead of UTC.

Set timezone to an IANA name and schedule to one or more time windows written in Renovate schedule syntax. Renovate only creates or refreshes branches inside those windows.

Steps

  • Set timezone to an IANA value like America/New_York.
  • Add a schedule array of natural-language windows.
  • Optionally use a preset like schedule:weekly via extends.

Schedule config

renovate.json
{
  "extends": ["config:recommended"],
  "timezone": "America/New_York",
  "schedule": ["after 10pm every weekday", "before 5am every weekday", "every weekend"]
}

Gotchas

  • timezone must be an IANA identifier such as Europe/London, not an abbreviation like EST.
  • The schedule limits when branches are created or updated; it does not force existing PRs to close.
  • For a monthly cadence, prefer the schedule:monthly preset over hand-writing the window.

Related guides

Run this faster and cheaper on Latchkey managed runners. Start free →