Skip to content
P0k3sm0t edited this page May 21, 2026 · 6 revisions

Ray5 Pilot FAQ

What is Ray5 Pilot?

Ray5 Pilot is a local web controller for the Longer Ray5 laser engraver. It provides dashboard controls, SD workflows, status monitoring, GRBL settings, ESP32 tools, camera overlay features, timelapse support, and update helpers.


Does Ray5 Pilot replace LightBurn?

No. Ray5 Pilot is not a design program. It is a controller/workflow helper for the Ray5.

You can still design in LightBurn or other laser software, then use Ray5 Pilot for import, upload, SD file, camera, and controller workflows.


What is the GRBL page?

The GRBL page reads and edits Ray5/GRBL $ settings.

It was previously called Firmware Settings.


What is the ESP32 page?

The ESP32 page reads Ray5 ESP3D information and EEPROM settings.

It can show ESP3D info, WebSocket status, EEPROM settings, and command tools. It can also save EEPROM settings with automatic backups.


Where are backups stored?

Backups are organized under:

backups/esp32/
backups/grbl/
backups/updates/

Manual download backups go to your browser's download folder.


Does Ray5 Pilot back up before saving settings?

Yes. GRBL and ESP32 saves create automatic local backups before writing settings.

If the automatic backup fails, the save is aborted.


What is a safe ESP32 test setting?

Use:

SD/history

It is safer than Wi-Fi, IP, password, port, or radio settings.


Can I use Ray5 Pilot without the real laser on?

You can use the Ray5 emulator for many tests.

Set Ray5 Pilot to:

Host: 127.0.0.1
HTTP: 8848
WebSocket: 8849

Why does the update package include a SHA256 file?

The SHA256 file lets Ray5 Pilot and users verify that the downloaded ZIP matches the published release asset.


Should I upload config.json to GitHub?

No. config.json is local/private. It can contain IPs, paths, and preferences.

Use config.example.json for shareable defaults.

Clone this wiki locally