Skip to content

Updates

github-actions[bot] edited this page Nov 17, 2026 · 1 revision

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:

  • Stable (the default) -- the public releases. Choose this unless you have a reason not to.
  • Beta -- builds that RSJ has tested on its own lab but that are newer than the latest Stable release. You get new features earlier, and you also get every Stable release as it comes out. A Beta build may still have rough edges.
  • Alpha -- RSJ's private development builds. It needs a GitHub token for the private repository and is not meant for schools.

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

  • The installer must be signed by RSJ Software Ltd. An installer signed by anyone else, or not signed, is refused.
  • Its checksum must match the one published with the release.
  • It must be a newer version than the one running. An update never moves the server backwards.

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

  • The check says it could not be completed. The server could not reach GitHub, or GitHub did not answer. Check the server's internet access and any web filter or proxy (see Firewall and Network), then Check for updates again.
  • An update failed. The feed says why. Your current version keeps running. Try Update now; if it fails again, make a Support Bundle and get in touch.
  • You would rather stay on a version for now. Untick Allow automatic updates. Nothing installs until you choose Update now.

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

Clone this wiki locally