--- title: Advanced LightBurn Bridge Setup description: Learn how to set up and configure a custom LightBurn Bridge using a Raspberry Pi. This guide covers flashing the image, advanced WiFi setup, and configuration options for optimal performance. --- [Skip to content](https://support.salasers.com/advanced-lightburn-bridge-setup#main-content) English Show submenu for translations [Submit a Ticket](https://support.salasers.com/kb-tickets/new?hsLang=en) ![MicrosoftTeams-image.png\]](https://support.salasers.com/hs-fs/hubfs/Logos/MicrosoftTeams-image.png?height=50&name=MicrosoftTeams-image.png) Open main navigation Close main navigation - English Show submenu for translations - [Submit a Ticket](https://support.salasers.com/kb-tickets/new) - Go to salasers.com Go to salasers.com Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [SA Laser Knowledge Base](https://support.salasers.com/?hsLang=en) 2. [How-To Guides](https://support.salasers.com/how-to-guides?hsLang=en) # Advanced LightBurn Bridge Setup ## Supported Raspberry Pi Models If you’re looking to set up a custom LightBurn Bridge with a Raspberry Pi you already own or want to explore advanced configuration options, this guide will help you. LightBurn Bridge is only compatible with Raspberry Pi models 3B, 3B+, or 4. Other models are not supported. Additionally, LightBurn Software provides limited support for self-built devices. Please note: LightBurn Bridge is designed as a dedicated appliance. Modifying the installation beyond the steps outlined in this guide voids any warranties or support obligations from LightBurn Software. --- ### **Flashing the LightBurn Bridge Image to an SD Card** If you’ve purchased a pre-flashed SD card or a complete kit, you can skip this section unless you’re upgrading to a newer version. For upgrades: ![Supported Raspberry Pi Models](https://support.salasers.com/hs-fs/hubfs/Screenshot_118.jpg?width=485&height=366&name=Screenshot_118.jpg) 1. Power off the Raspberry Pi and remove the SD card from the slot on the bottom of the device. 2. Download the latest LightBurn Bridge disk image from the official source. 3. Use the Raspberry Pi Imager tool (recommended for its ease of use) to flash the image to a micro SD card (4GB or larger). Follow these steps: - Open Raspberry Pi Imager. ![Guide-AdvancedLightBurnBridge-PiImager1](https://support.salasers.com/hs-fs/hubfs/Guide-AdvancedLightBurnBridge-PiImager1.png?width=682&height=452&name=Guide-AdvancedLightBurnBridge-PiImager1.png) 1. - Select **CHOOSE OS** → **Use Custom**, then locate and select the downloaded `.img.xz` file. ![Guide-AdvancedLightBurnBridge-PiImager2](https://support.salasers.com/hs-fs/hubfs/Guide-AdvancedLightBurnBridge-PiImager2.png?width=682&height=452&name=Guide-AdvancedLightBurnBridge-PiImager2.png) ![Guide-AdvancedLightBurnBridge-PiImager3](https://support.salasers.com/hs-fs/hubfs/Guide-AdvancedLightBurnBridge-PiImager3.png?width=649&height=440&name=Guide-AdvancedLightBurnBridge-PiImager3.png) - Insert the SD card into your computer, select **CHOOSE STORAGE**, and choose the correct device. ![Guide-AdvancedLightBurnBridge-PiImager4](https://support.salasers.com/hs-fs/hubfs/Guide-AdvancedLightBurnBridge-PiImager4.png?width=682&height=452&name=Guide-AdvancedLightBurnBridge-PiImager4.png) - Click **WRITE** to begin the process. After completion, the tool will verify the write was successful. Once completed, your SD card is ready for use. Insert it into the Raspberry Pi and follow the primary LightBurn Bridge setup guide. --- ### **Advanced Configuration** #### **Manual WiFi Setup** If your network has specific requirements (e.g., a hidden SSID), you can pre-configure the WiFi connection using the `wifi.txt` file. 1. Insert the SD card into your computer and open the **boot** partition. ![Guide-AdvancedLightBurnBridge-PiBootDrive](https://support.salasers.com/hs-fs/hubfs/Guide-AdvancedLightBurnBridge-PiBootDrive.png?width=593&height=436&name=Guide-AdvancedLightBurnBridge-PiBootDrive.png) 2. Create a file named `wifi.txt` and open it in a simple text editor (e.g., Notepad). 3. Add the following lines: plaintext Copy code `ssid=YourNetworkSSID pass=YourNetworkPassword` Replace the placeholders with your actual network name and password. Leave out the `pass` line if your network is not password-protected. 4. Save the file, eject the drive, and reinsert the SD card into the Raspberry Pi. The device will attempt to connect to the specified network on boot. If successful, the file will rename to `wifi.txt.loaded`. If it fails, it will rename to `wifi.txt.failed`, and the WiFi configuration access point will become available. #### **Bridge Configuration Options** Additional configuration can be done using the `bridge.json` file, located in the boot partition after the device has been powered on at least once. You can also create this file manually with the following template: json Copy code `{ "laser_ip": "10.0.3.3", "device_type": "ruida", "ap_name": "LightBurn Bridge E4B7" }` - **laser\_ip**: The static IP address for the Ruida laser controller. Default: `10.0.3.3`. Do not change unless necessary to avoid conflicts. - **device\_type**: Set to `ruida` (default). - **ap\_name**: Defines the WiFi access point name. By default, it is "LightBurn Bridge" followed by four random characters (e.g., `LightBurn Bridge E4B7`). You can customize this to any name between 6 and 32 characters, excluding certain special characters. After making changes, save the file, reinsert the SD card into your Raspberry Pi, and power it on. - [Lightburn](https://support.salasers.com/lightburn?hsLang=en#main-content) - [Lightburn For Galvo (Fiber)](https://support.salasers.com/lightburn?hsLang=en#lightburn-for-galvo-fiber) - [Lightburn For Gantry (Co2,RF)](https://support.salasers.com/lightburn?hsLang=en#lightburn-for-gantry-co2rf) - [Fiber (Galvo) Lasers](https://support.salasers.com/fiber-galvo-lasers?hsLang=en#main-content) - [Troubleshooting](https://support.salasers.com/fiber-galvo-lasers?hsLang=en#troubleshooting) - [Co2 Lasers](https://support.salasers.com/co2-lasers?hsLang=en#main-content) - [Razor Series](https://support.salasers.com/co2-lasers?hsLang=en#razor-series) - [Troubleshooting](https://support.salasers.com/troubleshooting?hsLang=en) - [EzCad 2](https://support.salasers.com/ezcad-2?hsLang=en) - [How-To Guides](https://support.salasers.com/how-to-guides?hsLang=en) - [Explainers](https://support.salasers.com/explainers?hsLang=en) - [Tools & Features](https://support.salasers.com/tools-features?hsLang=en#main-content) - [User Interface](https://support.salasers.com/tools-features?hsLang=en#user-interface) - [Essential Functions](https://support.salasers.com/tools-features?hsLang=en#essential-functions) - [Layout and Design](https://support.salasers.com/tools-features?hsLang=en#layout-and-design) # San Antonio Laser SALasers.com Help Center Copyright © 2026, San Antonio Laser