Creating & Managing Schedules

ImmyBot Standard and ImmyBot Forever Clients only

If you’re an ImmyBot starter client, you do not have access to Schedules in ImmyBot

Overview

This document is intended to show you how to create schedules in ImmyBot for ongoing maintenance. Within Schedules you can manage when maintenance runs for your endpoints, set whether to send notification emails out, and choose which deployments to apply the Schedule to.

Prerequisites

Access to an ImmyBot instance that is either Immy Standard or Immy Forever.

Creating a Schedule

  1. Navigate to Schedules on the left hand column
  2. Click New at the top
  3. Fill out this form as necessary
  4. Click Create

Cron Expressions in ImmyBot

Common Examples

Description Cron Expression
Every day at 2:00 AM 0 2 * * *
Every Sunday at 3:00 AM (weekly maintenance) 0 3 * * 0
Every weekday at 6:00 AM (business hours prep) 0 6 * * 1-5
First day of every month at midnight 0 0 1 * *
Every Monday at 1:00 AM 0 1 * * 1

Field Reference

โ”Œโ”€โ”€ Minute (0-59)
โ”‚  โ”Œโ”€โ”€ Hour (0-23)
โ”‚  โ”‚  โ”Œโ”€โ”€ Day of Month (1-31)
โ”‚  โ”‚  โ”‚  โ”Œโ”€โ”€ Month (1-12)
โ”‚  โ”‚  โ”‚  โ”‚  โ”Œโ”€โ”€ Day of Week (0=Sun, 6=Sat)
โ”‚  โ”‚  โ”‚  โ”‚  โ”‚
*  *  *  *  *

Tips

  • ImmyBot uses standard 5-field cron (no seconds field)
  • Times are evaluated in the tenant’s local timezone if configured, otherwise UTC
  • Schedules are allowed to run at most once per day
  • For patching windows, pairing a maintenance schedule with a detection schedule (e.g. detect daily, remediate weekly) is a common pattern

Unsupported Schedule Patterns

ImmyBot does not support sub-daily or interval-based schedules. The symbols *, ,, /, and - are not permitted in the minute or hour fields โ€” both must be set to a single fixed value. This means expressions like */30 * * * * (every 30 minutes) or 0 */6 * * * (every 6 hours) are invalid.

ImmyBot also does not support interval-based day patterns such as:

  • “Every other Wednesday”
  • “Every 3rd weekday”
  • “Every other week on Tuesday and Thursday”

Cron has no concept of “every N weeks” or alternating days, and ImmyBot’s once-per-day limit means these patterns cannot be approximated with step syntax either.

Creating Schedules for Specific Tenants

There are 2 ways to go about this.

  1. Follow the Creating a Schedule instructions above and set Tenant in the Target section to whoever you need it to apply to
  2. Create the Schedule within the Tenant itself
    1. Navigate to Tenants on the left hand column
    2. Click on Schedules
    3. Click on New
    4. Fill out the form as necessary

Deleting a Schedule

  1. Navigate to Schedules on the left hand column
  2. Click on the Red Trashcan button to the left of the Schedule you want to delete

Recovering a Schedule

ImmyBot does not support recovery of Schedules natively, however, you can look at the Audit Log and recreate the deleted Schedule.

  1. Navigate to Show More > Audit
  2. Filter the Object Type to Schedule
  3. Find the Schedule that was deleted and expand the audit log
  4. This contains the information of the schedule that was deleted. You will need to follow the Creating a Schedule instructions above and recreate the Schedule.

Caveats and Considerations

ImmyBot will run every schedule applied to a tenant or endpoint, there is no inheritance for schedules like there is for deployments. Keep this in mind as you move forward with creating and applying tenants.

Best Practices

Please see Best Practices for our recommendations.

Was this article helpful?