Skip to content

Adding Your Laser to LightBurn

LightBurn can't control every laser, but it can talk to a number of different types of laser controllers, all of which use different ways of communicating, and have different abilities and settings.

This step tells LightBurn what you have.

If you've never configured a device in LightBurn, you'll be brought here automatically when you run the software. It is important that you pick something because the interface in LightBurn will change depending on the capabilities of the laser you choose.

If you've done this before, but want to change your laser, or add a new one, click the 'Devices' button in the Laser Window to bring up the devices list.


LightBurn can also be configured to control more than one laser, and there are settings stored for each device. If you don't pick one, we have nowhere to put these settings, and a number of features within LightBurn will not work until this is set up.

The Devices page


This is the Devices page in LightBurn. Here you will see a list of all the laser devices you've added to LightBurn, or an empty list when you're first starting.

The simplest way to proceed is to click 'Find My Laser' and let LightBurn try to figure out what you have. If that doesn't work, your laser connects with Ethernet, or you have a Marlin device, you'll need to use 'Create Manually'. If you're using a LightBurn Bridge device, you can use the LightBurn Bridge setup.

You can also import export a laser configuration from another computer using the Export button on this page from the source computer, and then import it to the new install using the Import button. Export will create a .lbdev file containing all of the device specific information LightBurn requires.

What if I don't have a laser yet?

We get asked this frequently - You don't ever need to connect a laser to LightBurn to use it, but LightBurn will not run without a device profile configured, because it needs a place to store some settings, and wants to know what options to show you in the interface. If you use a laser that accepts files on a USB drive, for example, LightBurn needs to know which controller it uses so it can produce the correct output files.

If you don't have a laser yet, or don't know what you're going to buy and just want to try it out, you can just set up an arbitrary device profile, because these options don't affect the design side of things, just the machine output and laser settings.

In either case, use Create Manually and configure the things you can, and guess at whatever you don't know - it won't matter in the end. When you finally do get your laser, you can come back to this screen, select the 'dummy' profile you set up, and click 'Remove'. Close the window, restart LightBurn, and the software will guide you through the setup again, pulling many of the settings from the controller of your machine. If you get it mostly right, you can double-click the existing profile, then go through the pages and change anything you need to later. Either way works.