Schedule a Script
Phase 5 — Scripts & Automation · OpenFrame Onboarding
Some scripts shouldn't wait for you to remember them — nightly cleanups, weekly reports, a one-time run at 2 a.m. when nobody's working. The Scripts Schedules tab lets you set a script to run at a date and time, optionally on repeat, against the devices you choose.
Before you start
- The script you want to schedule already exists in your Scripts List (build one first via Create Your First Script).
- You know the devices (or device tags) it should hit.
- You've decided the cadence — one-time, or every N days/weeks/months.
Create the schedule
Go to Scripts → Scripts Schedules → Add Schedule. You'll get the New Script Schedule form.
- Schedule Name — what this run is, e.g. Nightly Temp Cleanup.
- Select Date and Select time — when it first runs.
- Repeat Script Run — tick this to make it recurring. You then set an interval (a number) and a unit: Day, Week, or Month (e.g. every 1 Day). Leave it unticked for a one-time run.
- Supported Platform — Windows or MacOS, so the script targets the right machines.
Add the script(s)
Under Scheduled Scripts:
- Select Script from the dropdown (it lists scripts matching your chosen platform).
- Each script gets its own Timeout, and you can Add Script Argument / Add Environment Var for that script — same input rules as a manual run (match the field to what the script reads).
- Click Add Script to chain more than one script into the same schedule.
Then click Save Schedule.
Assign the devices
Here's the part that's easy to miss: devices are assigned separately from the schedule itself. On the Scripts Schedules list, open the schedule's "…" menu and choose Edit Devices.
That opens the Schedule Devices picker — the same selector you've seen on monitoring policies:
- Select Specific Devices — tick individual machines (this is the mode available today).
- Select Devices by Criteria — auto-include current and future devices matching criteria. Marked COMING SOON.
- Use Available Devices / Selected Devices tabs, Search, the Device Tags filter, or Add All Devices, then Save Devices.
The schedule's Devices count on the list reflects what you assigned.
Manage it later
On the Scripts Schedules list each row shows the Script, OS, Date & Time, Repeat (e.g. Daily / Once), and Devices count. The "…" menu gives you Edit Schedule (timing and scripts) and Edit Devices (targets); the arrow runs/opens it.
Quick checklist
- Named the schedule and set Date + Time
- Chose one-time vs Repeat (interval + Day/Week/Month)
- Selected the platform and added the script(s) with any inputs
- Saved the schedule, then used Edit Devices to assign targets
- Confirmed the Devices count looks right on the schedules list
What's next
Scheduled runs report back just like manual ones — Script Results & Output Logs shows you how to read the output and debug a failure.
Based on OpenFrame v0.9.19. "Select Devices by Criteria" is a roadmap item — re-check the console before treating tag auto-targeting as available.
