The dashboard tells you when there is a newer version, and installs it for you. This page is what to expect, and what to do first.
Install updates through Settings → System update, off air. An available update does not install itself; do not copy files directly onto the router to update it.
Use the Companion's built-in update flow for phone app updates too. Publishing an APK does not install it on a phone; Android still asks you to confirm installation.
Settings → System update. It shows Installed, Latest and Checked, plus the available update's summary.
Use Check now to force a fresh check. The check normally reads a cached answer so the dashboard does not freeze while the router is on a weak connection.
Leave Tell me when there is a new version on if you want the dashboard to warn you. Turning it off stops the update strip, but you can still come back to this card and check by hand.
When there is a new one, you will also see a strip across the top of every tab. Closing that strip closes it everywhere — it is remembered on the router, not in the browser you closed it in — and it comes back on its own when the next version is released.
Download a backup. It is the section immediately above System update, and it is one file with your whole setup in it: everything on the settings screen, your bonding configuration, the timer design, header chips, and every overlay's colours and placement.
The router does save a copy of your configuration for itself before an update starts. But that copy lives on the router, and a backup that only exists on the thing it is protecting is not really a backup. Take one of your own.
Do not update while you are live. An update replaces every dashboard file and restarts the web server on the router. The dashboard will be unreachable for part of it. If bonding is running when you open the page, it will say so.
When a release changes the SRTLA helper, the installer also reconnects an already running bond once to regenerate its background supervisor. Otherwise the new file could be installed while the old recovery loop kept running. An outdated supervisor is refreshed even if the helper itself already matches. A stopped bond stays stopped; an unchanged, current supervisor is not restarted.
Give it a few minutes. Two to five is normal, depending on your connection. The package is large enough that a weak cellular link may take longer.
Your settings, bonding configuration, overlays, timer and header chips are not touched. The installer keeps the saved configuration instead of replacing it with packaged defaults.
Reload the dashboard afterwards to pick up the new version.
A dashboard update can tell the router which Companion APK is current, but it does not interrupt a phone that is streaming. Update phones from the Companion tab or from the app's own prompt when the device is not live and is not lending its connection to the bond.
Do not change output format in the middle of a shot. Choose the format from Companion > Encoder and use Save for next start so it applies on the next start. A phone that claims it can record a format may still overheat or throttle while encoding it for a long stream.
Companion scene-message behaviour belongs to the phone app, not the dashboard updater. Keep every phone that might direct, encode or take over as a spare on the same current app version, so switching director does not change its behaviour.
This software is free and provided as-is, with no warranty. Help comes from the community: see how support works. An update is software replacing itself on a device you may be relying on. It is well tested and it protects your configuration, but nobody can promise you a perfect outcome on hardware they cannot see.
If an update leaves the router broken, install again from an invitation link. Your configuration will still be there, and if it is not, restore the backup you took.
“This router has no update key.” Your rig was installed before one-click updates existed. It needs one more install from an invitation link — after that the button appears and stays.
“The update helper is not installed.” Re-run the installer once to restore it.
“Only … KB free.” The router needs about 20 MB of room. Free some space and try again.
The button says “Reinstall now.” You are already up to date, but a tab reported that a helper installed by the package is missing. Reinstalling the same version puts those files back and keeps every setting.
The log on the Settings card is the first place to look; it names the step that failed. Over SSH:
sh /www/install.sh --check # version, and whether updates are set up cat /etc/irl-dashboard/last-update.json sudo /usr/bin/irl-update.sh log ls -l /root/www-backups/ # the configuration snapshots
An update never deletes those snapshots except to keep the newest five.