Skip to content
P0k3sm0t edited this page May 26, 2026 · 14 revisions

Ray5 Pilot Wiki

Ray5 Pilot is a local web controller for the Longer Ray5 laser engraver. It connects to the Ray5 ESP3D-style HTTP/WebSocket interface and gives you a dashboard for status, camera overlay, SD files, imports, timelapse, manual controls, live console commands, GRBL settings, ESP32 tools, and updates.

Ray5 Pilot is not a design program. Make your laser file in LightBurn, LaserGRBL, or another GRBL-compatible laser tool, then use Ray5 Pilot to upload, frame, run, monitor, and manage the job.

Ray5 Pilot can be run on Windows, Linux, and macOS when Python and the required packages are available. Windows users can use the BAT/EXE launchers or run manually with Python. Linux/macOS users can use start-ray5-pilot.sh or run python3 app.py manually. See Launcher Options for the best startup method for your operating system.

Start here

  1. Read Getting Started.
  2. Read Launcher Options so you know how to start the app.
  3. Open Settings and configure your Ray5 IP, camera, workspace limits, and safety options.
  4. Use Dashboard and Status Card to confirm the Ray5 is connected before running anything.
  5. Use Jobs and SD Card Files for file handling.
  6. Use GRBL only when you need to read or change controller $ settings.

Main pages

Safety first

Ray5 Pilot controls real laser hardware. Always supervise the machine, wear proper eye protection, use ventilation, use air assist when needed, and keep fire safety nearby. Do not expose Ray5 Pilot to the internet. The normal local address is:

http://127.0.0.1:5050

Only bind to a LAN address if you understand the risk. Ray5 Pilot is intended as a local single-user tool.

Clone this wiki locally