LightBurn Setup: After Your Machine Arrives (Mac)

Updated November 12, 2026

Applies to: All CO2 machines, on a Mac

This guide shows how to install LightBurn with your license key once your machine has arrived, and how to connect to the machine by USB or Wi-Fi.

LightBurn is layout, editing and control software for your laser. It talks to the laser directly, with no other software needed. The device profiles created at the factory control how LightBurn connects to and communicates with the machine, along with other settings needed for proper operation.

What you need

  • Mac with Wi-Fi
  • Internet connection
  • LightBurn license key
  • USB thumb drive (attached to the ignition keys of the machine)
  • USB cable

Install the software

  1. Go to the LightBurn download page.

  2. Download LightBurn to your computer. LightBurn runs on macOS 10.11 or later.

    Choosing the Mac version of LightBurn
  3. Double-click the LightBurn.dmg file to mount the disk image.

    LightBurn.dmg file
  4. Drag the LightBurn application into your Applications folder, then double-click the LightBurn icon to begin.

    LightBurn app icon
  5. Copy and paste your LightBurn license key, which is in your Getting Started email. Click the Activate License button, and click OK.

    License page with a license key entered

If LightBurn will not open because it cannot be verified

  1. Click Cancel.

    LightBurn cannot be opened warning
  2. Click the Apple logo, then click System Preferences.

    Apple menu with System Preferences
  3. Click Security & Privacy.

    Security and Privacy icon
  4. Click Open Anyway.

    Open Anyway button in Security and Privacy
  5. Click Open.

    Warning window with the Open button

Connect by USB

  1. Plug the USB thumb drive that came with your laser into an open USB port on your computer.

    USB thumb drive
  2. Power the machine on and let it reset fully.

  3. If the Devices window does not appear, click Devices in the Laser window.

    Laser window with the Devices button
  4. In the Devices window, click the Import button.

    Devices window with the Import button
  5. Go to the machine USB drive, named DISK_IMG.

    DISK_IMG drive
  6. Open the Settings folder.

    Settings folder on the USB drive
  7. Select the file ending in USB.lbdev, and click Open.

    File ending in USB.lbdev
  8. Select the new USB device in the Devices list and click OK.

    Devices list with the USB device
  9. In the Laser window, select the new USB device from the dropdown menu.

    Laser window device dropdown
  10. Plug one end of the USB cable that came with your laser directly into an open USB port on your computer.

    USB cable plugged into the computer
  11. Plug the other end into the bottom USB port on the right side of the machine.

    USB cable plugged into the machine
  12. In the Laser window, right-click the Devices button to reset the connection. It should now say Ready.

    Laser window showing Ready

LightBurn is now connected to your laser by USB.

Note: USB cables longer than 10 feet and USB hubs are not recommended. The signal deteriorates beyond about 10 feet, and the speed and power provided fall as the cable gets longer.

Connect by Wi-Fi

  1. Plug the USB thumb drive that came with your laser into an open USB port on your computer.

  2. Power the machine on and let it reset fully.

  3. If the Devices window does not appear, click Devices in the Laser window.

  4. In the Devices window, click the Import button.

  5. Go to the DISK_IMG drive on your computer and open the Settings folder. These first steps are the same as for USB, shown in the photos above.

  6. Select the file ending in WiFi.lbdev, and click Open.

    File ending in WiFi.lbdev
  7. Select the WiFi device in the Devices list, and click OK.

    Devices list with the WiFi device
  8. In the Laser window, select the new WiFi device from the dropdown menu.

    Laser window device dropdown
  9. Click the Wi-Fi symbol in your menu bar, as if you were connecting to your home Wi-Fi network.

    Wi-Fi symbol in the menu bar
  10. Select your laser from the list of available Wi-Fi connections, and click Connect.

    List of available Wi-Fi connections
  11. In the Laser window, right-click the Devices button to reset the connection. It should now say Ready.

    Laser window showing Ready

LightBurn is now connected to your laser by Wi-Fi.

Note: While your computer is connected to the laser by Wi-Fi, it cannot reach the internet over Wi-Fi.

Need a hand?

Email support@aeonlaser.us or call 321-260-2325. More ways to reach us are on the Support page.

← Back to the Knowledge Base