Overview
Admin Guide

Background Jobs

Access:Super Admin

SanctuaryOS runs a set of background jobs that keep your data current, raise alerts and send reminders without anyone pressing a button. This page lists every one, when it runs, and whether you can run it yourself.

Getting Here

Navigation: Settings → System → Background Jobs

Only a Super Admin can open this page. Every other role, including Lead Pastor, is refused.

Every Job Runs on Your Church's Clock

Times are in your church's timezone, not the server's. “Daily at 2:00 AM” means 2 AM where your church is, so a church in Regina and a church in Toronto each get the run at their own 2 AM. The page names your timezone at the top, and each job shows its schedule and its next run in that timezone.

A job that belongs to a module your church has turned off doesn't run. It is recorded as Skipped.

Job Schedule

JobModuleWhenRun by handWhat it does
serve-stats-recalcServeDaily at 2:00 AMYesRecalculates serve counts, confirmation rates and estimated hours for every team member, past members included. Only services that have happened count.
burnout-scanServeMondays at 1:00 AMAsks firstFlags volunteers serving more than your church’s burnout multiplier (2× by default) times their team’s 90-day average.
serve-escalationServeEvery 6 hoursAsks firstEscalates confirmations that timed out and tries to reassign the slot.
serve-reconfirmationServeDaily at 10:00 AMNot offeredSends "Still coming?" emails to confirmed volunteers serving in 24 to 48 hours.
screening-expiryServeDaily at 6:00 AMAsks firstTells the screening admins about volunteer screening checks that expire in the next 30 days, and again on the day one expires. Once per check; a renewed check reminds nobody.
milestone-scanCareDaily at 2:00 AMYesScans for upcoming birthdays, anniversaries and other milestones.
snooze-wakeupCareDaily at 3:00 AMYesWakes snoozed care items whose snooze has ended.
bereavement-anniversariesCareDaily at 4:00 AMYesCreates care items for bereavement anniversaries.
care-follow-up-remindersCareDaily at 7:00 AMYesReminds pastors in the app about overdue and due-today care items.
service-materialisationGatherEvery hourYesCreates services from your Service Schedules for the next 8 weeks.
absence-alert-scanGatherMondays at 7:00 AMYesFlags people who have missed church the set number of weeks in a row (any service, any campus), and resolves the alerts of those who came back.
circles-health-scoreCirclesDaily at 4:00 AMYesRecalculates every group’s health score from attendance, consistency (the meeting rate over its last 8 expected meetings) and size.
circles-event-meetingsCirclesEvery hourYesTells each leader of a group whose meeting was an event, once, after the event ends: “Fellowship Night counted as your meeting: 9 of 12 came. Review.” In the app.
circles-not-recordedCirclesDaily at 8:00 AMAsks firstOnly for churches that turned on “Remind leaders about meetings not recorded”: tells each group’s leaders, the morning after, about a meeting on the group’s calendar with no attendance and no “Didn’t meet”, and tells staff about one still not recorded after the days chosen. Nobody is told twice about the same meeting.
circles-join-digestCirclesNot scheduledNot offeredA digest email of pending join requests for group leaders. Not switched on.
monthly-statementsStatementsMonthly on the 1st at 6:00 AMNot offeredOnly for churches that have turned on Auto-generate monthly statements: prepares each donor’s giving statement for last month (not an official receipt), and emails it if Auto-email is also on.
email-campaignsFlockEvery minuteNot offeredSends each scheduled email campaign at its time, once. A campaign that cannot go (no mailing address, nobody to email) is marked Failed with the reason, and the admins are notified. It runs, and shows a last run, only when a campaign is due.
engagement-recalcFlockDaily at 5:00 AMYesRecalculates every person’s engagement score from attendance, groups, serving and giving.
category-age-checkFlockDaily at 6:00 AMYesOnly for churches that turned on “Tell me when someone’s age no longer fits their category”: tells the chosen people about anyone whose age no longer fits their category, once per person per mismatch. Nobody’s category is changed.
people-report-deliveryFlockDaily at 7:00 AMNot offeredEmails each saved People report that is on a weekly or monthly schedule, as a spreadsheet, to the staff chosen for it, each built with that person’s own access. Each report goes once, on its own day. Nothing is scheduled until someone schedules a report.
privacy-export-expiryFlockDaily at 3:00 AMYesDeletes prepared privacy exports (a copy of everything about a person) that nobody downloaded within 7 days.
zip-cleanupStatementsEvery 30 minutesNot offeredDeletes expired statement ZIP downloads.
invitation-expiryAuthDaily at 5:00 AMYesCleans up user invitations that have expired.
activity-retentionActivity LogDaily at 3:00 AMYesDeletes Activity Log entries past their retention period: Steward after 7 years, Security and sign-ins after 2, everything else after 3.
activity-digestActivity LogDaily at 7:00 AMNot offeredEmails each alert recipient the entries that alerted them in the last 24 hours, when the daily digest is on. Nothing is sent on a quiet day.
start-fresh-purgeStart FreshDaily at 3:00 AMYesDeletes Start Fresh backups older than 30 days, and previews nobody confirmed.
messaging-retentionMessagesDaily at 3:00 AMAsks firstDeletes Sanctuary Connect messages older than the church’s message retention (Settings → Configuration → Connect). Nothing is deleted while it is set to Keep forever.
messaging-events-retentionMessagesDaily at 3:00 AMYesDeletes Sanctuary Connect’s delivery log older than 14 days. Messages are kept; a device away longer reloads its conversations.

The Circles join digest isn't scheduled, because group leaders are already notified of each join request as it arrives.

Running a Job by Hand

Run Now runs the job straight away, for your church only. It is the same run the schedule would make. The button waits until the job has finished, then tells you what happened: that it finished and how long it took, that it was skipped and why, or that it failed and the error.

A job can't run twice at once for the same church. If it is already running, from the schedule or from another press, Run Now is refused with a message to wait for it to finish.

Not every job has a Run Now button. A job that emails people is never offered by hand.

  • Yes: these only recalculate, skip what already exists, or remind in the app once a day, so running them again does no harm.
  • Asks first: the page tells you what will happen and asks you to confirm. burnout-scan notifies every team leader again and reopens burnout alerts they dismissed. serve-escalation takes the slot from volunteers who haven't answered in time and emails the next volunteer.
  • Not offered: the page says why instead of showing a button. serve-reconfirmation emails volunteers, and a second run the same day would email them again. monthly-statements emails donors, and each month is prepared only once. circles-join-digest emails every group leader. activity-digest emails alert recipients, and a second run would email them again. email-campaigns emails people: a campaign goes at the time set on it, and only once. zip-cleanup runs for every church at once.

Reading a Job's Status

  • Dot: green when the last run succeeded or was skipped, red when it failed, blue while running, grey if it has never run
  • Badge: Success, Failed, Running, Skipped or Never run
  • Schedule and next run: in your church's timezone
  • Last run: how long ago, how long it took, and, when it was skipped, why (for example “Skipped: Monthly statements are off for this church”)
  • Error: hover the warning icon on a failed job to read the error

A run that was cut off, because the server restarted or it had been running for more than three hours, shows as Failed with “Did not finish”. It doesn't block the job, so the next run goes ahead.

While Start Fresh is running for your church, every scheduled job for the church is recorded as Skipped instead of running.

Related Pages