- Archive
- /
- Scheduled Jobs
- /
- Scheduled Jobs Overview
Scheduled Jobs Overview
Learn how to automate recurring tasks in Foreman using scheduled jobs, including setup, frequency options, and live job monitoring.
Scheduled jobs let you automate repetitive tasks in Foreman so they run on a reliable, hands-off schedule. Instead of manually triggering actions like folder validation, attribute extraction, or permission updates, you pick a frequency from the visual schedule picker and Foreman takes care of the rest.
How It Works
Each scheduled job is defined by a frequency (hourly, daily, weekly, or monthly) and a job type. Foreman's background scheduler checks for due jobs every 30 seconds and executes them automatically. The jobs list auto-refreshes every 30 seconds so you always see current status without reloading the page.
Foreman allows a maximum of 3 concurrent jobs to run at any time. If more jobs are due simultaneously, they queue and execute as slots become available.
Visual Schedule Picker
You never need to write cron syntax. The schedule picker provides frequency tabs and intuitive controls:
| Frequency | Controls |
|---|---|
| Hourly | Runs once every hour at the minute you choose. |
| Daily | Pick a time of day and timezone. |
| Weekly | Pick a time of day plus one or more day-of-week toggles (Mon, Tue, Wed, etc.). |
| Monthly | Pick a day of the month and a time of day. |
You can also choose Run Once for one-off executions with a delay option (Now, 5 min, 15 min, 30 min, 1 hour, or 2 hours). See Run Once Scheduling for details.
Live Countdown Timers
Each job in the list displays a live countdown to its next scheduled run:
- Amber — less than 5 minutes until the next run
- Blue — less than 1 hour until the next run
- Grey — more than 1 hour until the next run
Hover over the countdown to see a tooltip with the full UTC datetime.
Available Job Types
User-facing jobs
These are the job types you can create and manage from the Scheduled Jobs page or from in-context schedule dialogs:
| Job Type | Description |
|---|---|
| Folder Validation | Compares the actual folder structure in your ACC project against the expected matrix and reports any discrepancies — missing folders, extra folders, or naming mismatches. |
| Folder Creation | Deploys the folder structure defined by your matrix into a project on a recurring basis, creating any folders that are missing. |
| Permission Application | Applies role-based folder permissions to project members according to your matrix configuration. |
| Attribute Extract | Runs a saved attribute extract definition and stores the output as an export file (CSV, XLSX, or template). |
| File Search | Executes a saved file search query and exports matching results. |
| Member Audit Snapshot | Captures a point-in-time snapshot of project membership and roles for audit and compliance tracking. |
System jobs (admin only)
These housekeeping jobs run automatically in the background and are only visible to administrators:
| Job Type | Description |
|---|---|
| Token Cleanup | Removes expired or revoked authentication tokens from the database. |
| Email Log Cleanup | Purges old email delivery logs past their retention period. |
| OpenIddict Pruning | Cleans up expired OAuth authorizations and tokens. |
| Access Request Auto-Approval | Automatically approves pending access requests matching pre-defined rules. |
System jobs are hidden from the regular Scheduled Jobs page. Administrators manage them from Admin > Scheduled Jobs.
Auto-Refresh
The scheduled jobs list displays a green Live indicator and automatically refreshes every 30 seconds. Countdown timers update in real time without a page reload so you can monitor upcoming executions at a glance.
Start with a daily schedule and adjust the frequency once you see how long jobs take in your environment. You can always change the schedule later from the inline edit dialog.