Maintenance Window
A maintenance window is a scheduled time slot during which the portal automatically applies pending firmware updates and skill deployments to a device. Instead of pushing updates immediately when they become available, the portal queues them and applies them only during the configured window — letting you control when devices restart or reload.
How it works
During a maintenance window, the portal automatically applies any pending updates to the device:
- Firmware update — If a newer firmware version is available on the configured channel, it is applied first.
- Skill sync — If skill changes have been made but have not yet been synced to the device, those changes will be applied.
Time window
Each maintenance window is 2 hours long, starting at the configured hour. For example, a window set to hour 21 runs from 21:00 to 22:59.
If a device is offline during its maintenance window, updates will be applied during the next scheduled window once the device comes back online.
Two levels: Organization and Device
Maintenance windows can be configured at two levels:
| Level | Where to configure | Who it applies to |
|---|---|---|
| Organization | Admin Settings → Maintenance Window | All devices in the organization that do not have a device-level window |
| Device | Device detail → Settings tab → Maintenance Window | That device only |
Device-level takes precedence. If a device has any maintenance window configured — even one that is disabled — it overrides the organization-level window entirely.
A disabled device-level maintenance window acts as an explicit opt-out from the organization schedule. If you want a specific device to never receive automatic updates, configure a device-level window and leave it disabled.
Maintenance window settings
| Setting | Options | Description |
|---|---|---|
| Enabled | On / Off | Activates or deactivates the maintenance window. When disabled, no automatic updates are applied. |
| Day | Each Day, Sunday–Saturday | The day of the week on which updates should be applied. Choose Each Day to run the window every day. |
| Hour | 0–23 | The start hour (24-hour clock). The 2-hour window begins at this hour. |
| Timezone | UTC / Device Location | Whether the hour is evaluated in UTC or in the local timezone of the device's assigned location. See Timezone below. |
| Firmware Channel | Stable / EARLY | The firmware release channel to source updates from. See Firmware channel below. |
Timezone
| Option | Behavior |
|---|---|
| UTC | The hour is interpreted as UTC regardless of where the device is located. Use this for consistent, globally synchronized windows. |
| Device Location | The hour is interpreted in the timezone of the device's assigned location. If the device has no location, UTC is used as a fallback. |
When deploying devices across multiple timezones, set the timezone to Device Location and schedule the same hour for all devices — each device will enter its maintenance window at that local hour rather than all at the same UTC moment.
Firmware channel
The firmware channel controls which firmware builds are eligible for automatic installation during a maintenance window.
| Channel label | Channel name | Description |
|---|---|---|
| Stable | stable | Released, production-grade firmware. Available to all organizations. |
| EARLY | early | Pre-release firmware with new features. Requires the Early Firmware feature to be enabled for your organization. |
When a higher channel is selected, the portal considers firmware from that channel and all channels below it. For example, selecting EARLY makes both early and stable firmware eligible.
Configuring an organization-level maintenance window
The organization-level window is the default schedule for all devices that do not have a device-specific override.
- In the portal, open Admin Settings from the navigation menu.
- Scroll to the Maintenance Window section.
- Configure the desired Day, Hour, Timezone, and Firmware Channel.
- Toggle Enable Maintenance Window on.
- Click Save.
To remove the organization-level window, click Remove in the Maintenance Window section.
Configuring a device-level maintenance window
A device-level window overrides the organization schedule for that specific device.
- Open the device detail view and click the Settings tab.
- Scroll to the Maintenance Window section.
- Configure the desired Day, Hour, Timezone, and Firmware Channel.
- Toggle Enable Maintenance Window on.
- Click Save.
To remove the device-level window (so the device falls back to the organization schedule), click Remove in the Maintenance Window section.
Removing a maintenance window
Clicking Remove in either the organization or device maintenance window form clears the window entirely:
- Removing the organization-level window means no devices in the organization will receive automatic updates (unless they have their own device-level window configured).
- Removing the device-level window causes the device to inherit the organization-level window.
A device with a disabled maintenance window is not the same as a device with no window. A disabled window is still present and actively prevents the organization schedule from applying. Clicking Remove eliminates the window entirely so the org schedule takes over.
Related pages
- Firmware — Manual firmware updates and update statuses
- Device Settings — Full reference for device configuration options