Import Configuration File

Setting up your laser engraver correctly in LightBurn is one of the most important first steps before engraving or cutting. If you are using the LONGER Ray5 miniS, you must import the correct .lbdev configuration file so LightBurn can communicate properly with the machine. This guide explains the exact setup process, including where to download the file, how to import it, and how to confirm the configuration was added successfully.

Table of Contents

  • What This Guide Covers
  • Why This Process Matters
  • Before You Start
  • Requirements
  • Precautions
  • Step-by-Step Tutorial
  • Common Problems and Solutions
  • Tips for Better Results
  • Frequently Asked Questions
  • Final Thoughts

What This Guide Covers

This tutorial shows you how to:

  • Download the Ray5 miniS.lbdev configuration file
  • Import the configuration file into LightBurn
  • Add the Ray5 miniS device correctly
  • Verify the import was successful
  • Change the speed unit to mm/min

Quick Answer

To import a LightBurn configuration file for the LONGER Ray5 miniS:

  1. Download the Ray5 miniS.lbdev file from the LONGER firmware download page.
  2. Open LightBurn.
  3. Click Devices in the Laser control module.
  4. Click Import.
  5. Select the .lbdev file.
  6. Click OK.
  7. Set the speed unit to mm/min in Edit > Settings.

The machine should then appear in the Devices list, and macro commands should appear in the Console window.


Why This Process Matters

Importing the correct LightBurn configuration file ensures that your laser engraver communicates properly with the software.

Without the correct .lbdev file, users may experience:

  • Incorrect machine dimensions
  • Communication problems
  • Improper movement behavior
  • Missing macro commands
  • LightBurn connection issues

Many beginners struggle during the first setup because the laser engraver is not properly configured in LightBurn. The configuration file simplifies the setup process and helps avoid manual configuration mistakes. Community discussions also show that missing or incorrect configuration files can cause operational issues in LightBurn.


Before You Start

Before importing the LightBurn configuration file, make sure:

  • Your LONGER Ray5 miniS is assembled correctly
  • LightBurn is installed on your computer
  • Your USB connection is functioning properly
  • The correct .lbdev file has been downloaded

If LightBurn is launching for the first time, the software may automatically open the New Device Wizard. If not, you can manually import the device configuration.


Requirements

You will need the following:

  • A computer with LightBurn installed
  • LONGER Ray5 miniS laser engraver
  • USB connection cable
  • Ray5 miniS.lbdev configuration file
  • Access to the official LONGER firmware download page

Download the configuration file from the official LONGER firmware page:
LONGER Firmware Download Page


Precautions

Before beginning the setup process, keep these important points in mind:

  • Use only the correct configuration file for your machine model.
  • Do not import configuration files intended for other laser engravers.
  • Avoid disconnecting the USB cable during setup.
  • Follow official machine specifications or instructions.
  • If LightBurn cannot detect the machine, verify cable connections and drivers first.
  • Some connection problems may be related to firmware or communication settings.

Step-by-Step Tutorial

Step 1: Download the Ray5 miniS.lbdev Configuration File

Action

Download the Ray5 miniS.lbdev file from the official LONGER firmware download page.

Expected Result

The configuration file should be saved to your computer and ready for import into LightBurn.

Important Notes

  • Make sure the downloaded file matches your exact machine model.
  • Do not rename the .lbdev file.
  • Store the file in an easy-to-find location such as the Downloads folder.

Official download source:
LONGER Download Center


Step 2: Launch LightBurn

Action

Open LightBurn on your computer.

If this is your first time launching LightBurn, the New Device Wizard should appear automatically.

Expected Result

You should see the LightBurn interface and possibly the setup wizard.

Important Notes

If the wizard does not appear automatically, you can manually import the device in the next step.


Step 3: Open the Devices Menu

Action

In the Laser control module, click Devices.

Expected Result

The Devices window will open, allowing you to add or import laser engraver profiles.

Important Notes

The Devices menu is where LightBurn stores connected laser engraver configurations.


Step 4: Import the Configuration File

Action

  1. Click Import
  2. Locate the Ray5 miniS.lbdev file
  3. Select the file
  4. Click OK

Expected Result

The Ray5 miniS configuration should be added to LightBurn.

Important Notes

  • Make sure you select the correct .lbdev file.
  • Wait for LightBurn to finish importing before closing the window.

Step 5: Verify Successful Import

Action

Check the following inside LightBurn:

  • Macro commands appear in the Console window
  • Ray5 miniS appears under Devices in the Laser window

Expected Result

The machine should now be listed as an available device.

Important Notes

If the device does not appear:

  • Restart LightBurn
  • Re-import the configuration file
  • Verify the downloaded file is not corrupted

Users have reported configuration-related connection issues when incorrect files or firmware versions were used.

Step 6: Change the Speed Unit to mm/min

Action

  1. Go to Edit in the taskbar
  2. Select Settings
  3. Choose mm/min as the unit
  4. Click OK

Expected Result

LightBurn will now display speed values in millimeters per minute.

Important Notes

Using the recommended speed unit helps maintain consistency with machine settings and tutorials.

Common Problems and Solutions

Problem Possible Cause Solution
LightBurn cannot find the device Incorrect or missing .lbdev file Re-download the correct configuration file
Device does not appear after import Import process failed Restart LightBurn and import again
Machine shows “Busy” Firmware or communication issue Verify firmware compatibility
No macro commands appear Import incomplete Re-import the configuration file
USB connection fails Driver issue or cable problem Check CH340/CH341 drivers
Incorrect machine behavior Wrong configuration profile Use the correct Ray5 miniS file
Units display incorrectly Speed unit not changed Set units to mm/min

Tips for Better Results

  • Always download configuration files from official sources.
  • Keep a backup copy of your .lbdev file.
  • Update LightBurn to the latest stable version when possible.
  • Use quality USB cables to avoid connection interruptions.
  • Close other laser control software before using LightBurn.
  • Confirm your firmware matches your machine model before troubleshooting.

Some users have reported that running multiple laser control programs simultaneously can interfere with LightBurn communication.


Frequently Asked Questions

What is a LightBurn configuration file?

A LightBurn configuration file (.lbdev) contains device settings that allow LightBurn to communicate properly with a laser engraver.


Where can I download the Ray5 miniS.lbdev file?

You can download it from the official LONGER firmware page:
LONGER Firmware Downloads


Why is my device not showing up in LightBurn?

Possible causes include:

  • Incorrect configuration file
  • Failed import process
  • USB connection problems
  • Driver issues

Try re-importing the file and restarting LightBurn.


What does mm/min mean in LightBurn?

mm/min stands for millimeters per minute. It is the speed measurement used for laser movement and engraving operations.


Can I use a configuration file from another machine?

No. You should only use the configuration file intended for your exact machine model.

Using incorrect profiles may cause improper machine behavior.


What happens if I skip importing the configuration file?

LightBurn may not communicate correctly with the laser engraver, which can lead to movement errors, connection issues, or incorrect settings.


Why are macro commands important?

Macro commands help automate common machine actions and indicate that the configuration imported successfully.


Does LightBurn automatically detect the Ray5 miniS?

Not always. In many cases, you must manually import the .lbdev file first.


Final Thoughts

Importing the correct LightBurn configuration file is a critical part of setting up the LONGER Ray5 miniS. The process is straightforward, but using the correct .lbdev file and verifying the import carefully can prevent many common connection and configuration problems later.

By following the exact steps above, you can properly configure LightBurn, ensure the machine appears correctly in the Devices list, and prepare your laser engraver for reliable operation.

For additional setup files and official resources, visit:
LONGER Official Website