Skip to content

docs(general): warn about empty TZ env breaking internal cron scheduler#643

Open
singhvishalkr wants to merge 1 commit intodirectus:mainfrom
singhvishalkr:docs-512-cron-tz-warning
Open

docs(general): warn about empty TZ env breaking internal cron scheduler#643
singhvishalkr wants to merge 1 commit intodirectus:mainfrom
singhvishalkr:docs-512-cron-tz-warning

Conversation

@singhvishalkr
Copy link
Copy Markdown

Fixes #512.

Tracing the CronError: ERROR: You specified an invalid date reported in Dec 2025 ended up exactly where @the-other-dev landed on the thread: Directus 11.13 swapped node-schedule for cron, and cron reads the process TZ env var (which node-schedule ignored). Setting TZ="" (empty string, which is what some orchestrators like UnRAID emit by default) now crashes the telemetry scheduler at startup before anything else can run, and the same would affect TUS cleanup and any schedule flow operations.

ComfortablyCoding asked on the issue to document this rather than change defaults, so I added a single warning callout in configuration/general.md right after the main env-var table that tells people to either leave TZ unset or set it to a valid IANA zone.

Only text change; no variable additions.

@singhvishalkr singhvishalkr requested a review from a team as a code owner April 23, 2026 05:26
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 23, 2026

@singhvishalkr is attempting to deploy a commit to the Directus Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document valid TZ is required for cron

1 participant