How to Set Up LightBurn for the First Time: A Step-by-Step Guide

LightBurn is the industry-standard front-end for diode and CO2 laser engravers. Once it’s set up, you don’t think about it again — you just open the app, drop in a design, hit start. The first-time setup, however, trips up enough beginners to be worth a proper walk-through. This guide takes you from “downloaded the installer” to “engraving your first design” in under 15 minutes.

We’ll use the AnyLaser X1 as the example engraver, but the steps work for any GRBL-compatible diode laser.

Step 1 — Install LightBurn

Go to lightburnsoftware.com and download the installer for your OS. Mac, Windows, and Linux are supported. The free 30-day trial gives full access; the perpetual license (around €60 for the diode/galvo tier) is worth it once you’re sure you’ll keep using the engraver.

Run the installer. On Mac, you may need to allow the app in System Preferences → Security. On Windows, Windows Defender will pause for a moment — let it through. Linux users: chmod +x the AppImage and run.

When you launch LightBurn for the first time, it asks if you want to import an existing profile or set up a new device. Choose set up a new device.

Step 2 — Add your device

LightBurn shows two options for adding a device: Find My Laser (auto-detect) or Manually.

For the AnyLaser X1, plug the USB-C cable into your laptop, ensure the engraver is powered (the indicator inside lights up), and click Find My Laser. After 5–10 seconds, LightBurn detects a generic GRBL device on a COM port. Accept the suggested settings and give it a name like “AnyLaser X1.”

If auto-detect doesn’t see it:

• Click Add Manually instead.
• Choose GRBL as the controller.
• Choose Serial as the connection.
• Set the work area to 100 mm × 100 mm (X1 default — adjust to your unit’s spec).
• Pick the COM port (Windows shows COM3, COM4, etc.; Mac/Linux show /dev/cu.usbmodem...).

Step 3 — Configure preferences

A few settings to set once and forget:

Edit → Settings:

• Display units: mm (metric) — the X1 spec sheet is in mm.
• File units: mm.
• Default file format: LightBurn (.lbrn2).

Edit → Device Settings:

• Confirm work area is correct for your engraver.
• Set max speed to a sane value (4000-6000 mm/min is comfortable for diode lasers).
• Origin position: most diode units use front-left as origin.

Edit → Material Library:

• Click Add New and create a row for “Basswood line art” with 100% power and 4000 mm/min.
• Add another for “Basswood raster fill” with 80% power and 2500 mm/min.
• Build the library out as you find settings that work — saves you re-tuning every project.

Step 4 — Frame and dry-run

Drop a simple design into LightBurn — drag a JPG of a logo, or use Tools → Text Tool to type your name. Position it on the virtual work area where you want it on your physical material.

Place a test piece of basswood under the laser head. Click Frame (the small icon that looks like a square with a dot at the corner). The laser head moves around the perimeter of your design at very low power so you can see exactly where it’ll engrave. If it lines up, great. If not, drag the design in LightBurn and re-frame.

The Frame test prevents the most common first-time mistake: discovering your design is engraving in the corner of nothing instead of the center of your basswood.

Step 5 — Run your first engraving

Wear the safety glasses. Confirm ventilation. Click Start.

The laser fires, the head moves, the design appears. LightBurn shows progress in real-time at the bottom of the window. When it finishes, the laser turns off automatically.

Lift the material out — your first LightBurn engraving is done. Save the LightBurn project file (File → Save) so you can re-run the same job on another piece without redoing the setup.

Common first-time issues

LightBurn says “no device connected” even though the engraver is plugged in. Close LightBurn, unplug and replug the USB-C cable, reopen LightBurn. If still no go, check that no other program (LaserGRBL, Arduino IDE, terminal) is holding the serial port. Reboot if necessary.

The engraving is faded and pale. Either the focus is wrong or the speed is too high. Re-focus first; if still pale, drop the speed by 30%.

The engraving has burnt through the material. Power too high or speed too low. Reduce power to 60% and try again on a fresh piece.

Lines look blurry or doubled. The engraver is moving on a wobbly surface, or the material isn’t sitting flat. Both fix the same way: flat, level, stable.

LightBurn doesn’t see the X1 after a Mac update. macOS sometimes blocks new USB devices after a security update. System Preferences → Security & Privacy → allow the connection.

Building your Material Library

The Material Library is LightBurn’s most underused feature. Once configured, it stores your engraving settings per-material so you never have to type “100% power, 4000 mm/min” again.

Setting up the library

Edit → Material Library → Add New opens a row where you enter:

• Material name (e.g. “Basswood line art”)
• Cut/engrave settings (speed, power, passes)
• A note describing the result you’ll get

Save 5-10 entries to start, covering the materials you use most often:

• Basswood line art (100% / 4000 mm/min)
• Basswood raster fill (80% / 2500 mm/min)
• Birch ply line art (100% / 4500 mm/min)
• Veg-tan leather (35% / 3000 mm/min)
• Kraft cardstock (15% / 5000 mm/min)
• Powder-coated tumbler (100% / 2000 mm/min)
• Slate coaster (100% / 2000 mm/min, 2 passes)
• Anodized aluminum (100% / 1500 mm/min, 2 passes)

Apply by clicking the material in the library before assigning a layer. The settings auto-fill.

Per-project templates

For repeat orders (Etsy listings, wedding favors), save the entire project as a template file. Open the template, swap one variable text field, and re-run. Saves 30-60 seconds per piece — across 50 orders that’s 25-50 minutes back per batch.

LightBurn project files (.lbrn2) preserve all settings, including the Material Library row currently selected. Stash a “wedding-favor-template.lbrn2” with the static design baked in; for each new order, open it, edit the guest name, hit Start.

Advanced LightBurn tips beginners miss

Three features that most beginners ignore for months because they’re not on the main toolbar:

Test pattern generator (Tools → Material Test)

LightBurn ships with a built-in tool that runs a 5×5 grid of test squares at varying speeds and powers on a single piece of material. After running it, you have empirical data on which settings give the best contrast on your specific basswood batch. Run it once per new material batch and you’ll never have to guess.

Print and Cut alignment

If you’re doing pieces where the engraving aligns to a printed graphic on the same material (e.g. engraving over a sticker layer), LightBurn’s Print and Cut feature uses cross-hair markers for sub-millimeter alignment. Niche but powerful for layered art.

Frame at low power vs high speed

By default, LightBurn’s Frame function uses very low laser power. If you can’t see the outline well on dark material, switch Frame mode to “high speed/low power” — it traces faster with a brief flash of detectable laser. Useful on slate, dark walnut, and powder-coated surfaces where the default frame is invisible.

Backup and version your project files

LightBurn project files (.lbrn2) accumulate over time. A simple backup discipline saves you from re-doing setup when something goes wrong:

• Cloud sync. Drop your Documents/LightBurn folder into Dropbox / iCloud / OneDrive. Free versioning, free backup.
• Versioned filenames. “wedding-favor-template-v3.lbrn2” beats “wedding-favor-template.lbrn2” when you need to revert a tweak that didn’t work.
• One folder per project. Keep all related .lbrn2 files in a project folder along with the SVG source files and exported PDFs.

LightBurn keyboard shortcuts that save time

After hundreds of jobs, these shortcuts become muscle memory:

• Space bar — pan the canvas (when canvas-tool is active)
• F — Frame the current selection (low-power outline)
• Ctrl/Cmd+Enter — Start the job
• Ctrl/Cmd+Z / Y — undo / redo
• Ctrl/Cmd+G / Shift+G — group / ungroup objects
• Ctrl/Cmd+D — duplicate selection
• R — switch to rotate tool
• N — switch to select/edit nodes (vector editing)
• B — switch to rectangle tool

Once these are second nature, designing and running a job feels closer to using Photoshop than to using a CNC controller — which is the point.

For more in-depth tutorials, browse our laser engraving project ideas or, if you’re still shopping for a machine, our buyer’s guide.