Updates

Updates

Ray5 Pilot can check for updates from the Settings Support card.

Where updates appear

Open:

Settings > Support / Update

You may see:

• Current version
• Update available status
• Update Ray5 Pilot button
• Download Latest Source link
• Update status message

In-app update rules

In-app updates are intentionally limited to published GitHub Release assets. Ray5 Pilot checks release metadata and requires a trusted release ZIP and SHA-256 verification.

Branch archives such as main.zip are not installed by the in-app updater.

Recommended update method

1. Back up your Ray5 Pilot folder or at least config.json.
2. Use the in-app update only when it shows a valid release update.
3. Let Ray5 Pilot close and restart through the updater.
4. Reopen Settings and verify the version.
5. Check Dashboard status before running jobs.

On Linux/macOS, start Ray5 Pilot after an update with:

./start-ray5-pilot.sh

If the shell script is not executable after extracting a release ZIP, run:

chmod +x start-ray5-pilot.sh

Download Latest Source

The source download link is useful for manual inspection or development. It is not the same as an approved in-app release install.

For manual installs, use the release ZIP when available. The release ZIP is built to include the files needed for Windows and Linux/macOS startup, including platform_utils.py and start-ray5-pilot.sh.

Troubleshooting

Problem	Meaning	Fix
No update shown	You may already be current	Check release page manually if unsure
GitHub rate limit/403	GitHub blocked or limited the check	Try later or check manually
Update button missing	No valid release asset/checksum found	Use manual release download
Update failed checksum	Download is not trusted	Do not install; download again or report issue
App did not restart	Start Ray5 Pilot manually and check update status