Documentation

Updates

This page is also in the Groundskeeper wiki: https://github.com/rsjsoftwareltd/groundskeeper/wiki/Updates

How Groundskeeper finds, downloads and installs a new version, and how the computers running the RSJ Agent follow it. Everything here is under General Settings -> Updates, and only administrators can change it.

Checking for a new version #

Groundskeeper asks GitHub whether a newer release exists: Hourly, Daily (the default) or Weekly, and once more shortly after every service start. Check for updates asks straight away. When a newer version is found, a one-time notice appears in the Dashboard feed.

The check reads the public list of releases. Nothing about your school is sent with it.

Choosing a channel #

Update channel decides which releases the check looks at:

Switching from Beta back to Stable never installs an older version: the server stays on the Beta build it has until a newer Stable release arrives.

Updating by hand #

When a newer version is available, Update now downloads the installer through this server, checks it, and runs it in one click. The service stops for a minute or two while the new version is installed, then starts again on its own. The first start after an update can take a little longer than usual, and the service may restart once more as it puts its own Windows account back (that is expected). Your settings, data and licence key are kept.

Automatic updates #

Tick Allow automatic updates and, when the scheduled check finds a newer version, Groundskeeper downloads, checks and installs it without asking. Every automatic update, and any that fails, is written in the Dashboard feed.

Install updates automatically only between limits this to the hours you choose, for example 18:00 and 07:00 on the server's own clock (the window may cross midnight). An update found outside the window waits for the first check inside it. Leave both times blank to install as soon as an update is found. Update now ignores the window.

If an automatic update fails before its installer has started (a download that broke, for example), it is tried again at the next check, up to three times for that version. After that it is not tried again on its own, and the feed says so: use Update now once the cause is fixed.

What is checked before anything installs #

After installing, Groundskeeper checks that the new version has really started and is answering, and writes the outcome in the feed.

The computers follow the server #

Each Groundskeeper release carries a version of the RSJ Agent. After the server updates, every computer's agent updates itself at one of its next check-ins, and its Groundskeeper module is kept at the version this server serves. Nothing needs installing on the computers by hand. Agent Settings -> Devices shows each computer's version, and the reason if an update failed there.

Software advisory lists #

Check for newer advisory lists (on by default) downloads RSJ's signed list of published software security fixes once a day. It is one plain download of a public file; nothing about your school is sent. See Software Advisories.

If something goes wrong #

Last updated: 2026-11-16 (v0.196.14)