Schedule Pipeline Runs

On this page

Install an OS-native scheduler with one command.

1. Install

ondatrasql schedule "*/5 * * * *"

Standard 5-field cron syntax: minute hour day month weekday.

Pattern	Description
`/5 * * *`	Every 5 minutes
`0 * * * *`	Every hour
`0 9 * * *`	Daily at 09:00
`0 0 * * 0`	Weekly on Sunday
`0 22 * * 1-5`	Weekdays at 22:00

2. Verify

ondatrasql schedule

Schedule for "myproject"
  Backend:  systemd
  Unit:     ondatrasql-3f2a91b4.timer
  Cron:     */5 * * * *  (every 5 minutes)
  Status:   active
  Last run: Tue 2026-04-08 14:00:01 UTC
  Next run: Tue 2026-04-08 14:05:00

3. Remove

ondatrasql schedule remove

Platform Details

OS	Backend	Files
Linux	systemd user timer	`~/.config/systemd/user/ondatrasql-<id>.*`
macOS	launchd plist	`~/Library/LaunchAgents/sh.ondatra.<id>.plist`
Windows	WSL2	Use systemd inside WSL

Logs: journalctl --user -u ondatrasql-<id> (Linux) or ~/Library/LaunchAgents/sh.ondatra.<id>.log (macOS).

Project Identity

Each project gets a stable ID in .ondatra/project-id (generated on first install). Commit this file to git.