How to set up your Luxafor Signal light

Walkthrough for connecting your Signal to Wi-Fi, adding it to the Luxafor web app, and uploading audio files. No software install required — everything happens in your browser.

Before you start

You'll need three things to set up your Signal:

A data-capable USB-C cable. The cable that ships with your Signal works. A charge-only cable will not — the device needs a data connection for the initial configuration.
A 2.4 GHz Wi-Fi network and its password. Signal connects to 2.4 GHz networks only. Most home and office routers broadcast both 2.4 GHz and 5 GHz under separate names; pick the 2.4 GHz one.
A compatible browser. Setup uses the WebUSB API, which works in Google Chrome or another Chromium-based browser (version 89 or newer). Safari and Firefox are not currently supported for setup.

Note. You only need a Chromium browser for the initial setup. Once Signal is on your Wi-Fi, you can control it from any modern browser at luxafor.app.

Configure your Signal for the first time

Step 1 — Open the Luxafor web app

In Chrome (or another Chromium browser), go to luxafor.app.
Sign in or create an account.
Click Add Device in the top-right corner.
Select Signal from the list of device types.
Click the Configuration button.

(If your Signal has already been configured on a different computer, use Remote mode instead — see Configuration mode vs Remote mode below.)

Step 2 — Connect your Signal over USB

The browser will prompt you to select one of your connected Signal devices.

Plug your Signal into the computer using the included USB-C cable.
In the browser popup, select your Signal and click Connect.

If your device doesn't appear in the list, see Common issues at the bottom of this article.

Step 3 — Choose your Wi-Fi network

Once the device connects with the configurator:

Wait for Signal to scan for available networks.
Select your 2.4 GHz network from the list and enter the password — or fill in the network name and password manually if it's hidden.
Click Continue.

The device will attempt to connect to the Wi-Fi network. If it succeeds, it goes through a brief authentication step and is added to your Luxafor web app dashboard automatically.

If the connection fails, the configurator will return you to the previous step so you can re-enter the details. The most common cause is a typo in the Wi-Fi password or selecting the 5 GHz version of your network by mistake.

You're done. Signal is now controllable from luxafor.app from anywhere with an internet connection.

Adding audio files to your device

Signal has its own onboard storage for audio files. You upload them once, and the device plays them on demand — there is no audio streaming over the API.

Supported format. MP3 files under 1 MB each. Most short notification sounds (1–3 seconds) come in well under this limit.

To upload a file

Open luxafor.app and sign in.
Either configure a new device using the steps above, or select an already-configured device from your dashboard.
Open the device's settings. You'll see a list of files currently on the device and an option to upload new ones.
Click Upload, choose your MP3 file, and wait for it to transfer.

Once a file is on the device, you can play it from any integration — the Shopify integration or your custom cloud API integration.

The file must stay on the device for any integration to play it. If you delete an MP3 from the device but a Shopify event still references its filename, nothing will happen when the event fires — and the event will not throw an error.

Configuration mode vs Remote mode — which one to use

When you add a Signal to your Luxafor dashboard, you'll see two options. The difference is which computer the device is physically plugged into:

Mode	When to use it
Configuration	When you have USB access to the device. Sets up the Wi-Fi network from scratch. Use this the first time you set up any Signal, or any time you need to change which Wi-Fi network it joins.
Remote	When the device has already been configured on a different computer and you want to add it to a second dashboard. Uses a one-time share code instead of a USB connection.

How to use Remote mode

On the computer where Signal is already configured, open the device in the dashboard and click Create share code. Copy the code (it starts with share_ ).
On the new computer, open luxafor.app and click Add Device → Signal → Remote.
Paste the share code into the input field and confirm.

The device now appears on both dashboards.

Important. If the same device is open in two browsers at once, each browser will override the device's light color when it sends a command. Last command wins. For most setups this is fine, but it can produce surprising behaviour if two people are sending colors at the same time.

Common issues

Check the cable. A charge-only USB cable will not work — you need a data-capable cable.
Check the port. Some USB hubs and front-panel ports don't reliably pass data; try plugging directly into the computer.
Check the browser. Setup requires Chrome (or another Chromium browser) version 89 or newer. Safari and Firefox will not show the device.
Try unplugging Signal, refreshing the page, and plugging it back in.

Wi-Fi connection keeps failing

Confirm you're on a 2.4 GHz network. Signal does not support 5 GHz. On many routers the two bands have similar but different names (e.g. MyHome and MyHome-5G ).
Re-type the password manually — copy-paste from a password manager sometimes adds invisible characters.
Check that the network isn't using WPA3-only. Signal supports WPA and WPA2.
Move closer to the router for setup, then move the device to its final location afterwards.

I configured Signal but it's not appearing on the dashboard

The device authenticates with the cloud after joining Wi-Fi. If your network blocks outbound connections to services.luxafor.io , the device will join Wi-Fi successfully but never show up online. Check with your network admin or, on a home network, try setting it up off your guest network.

I want to change Wi-Fi networks

Run through Configuration mode again with Signal plugged in over USB. Pick the new network and continue. The old credentials are overwritten.

Where to go next

Signal integration with Shopify — connect new-order alerts and other Shopify events to your Signal.
How to build a Signal integration through the cloud API — drive your Signal from a custom script, app, or service.

Need more help?

If your Signal isn't behaving the way this article describes:

Email: support@luxafor.com

(Mon–Fri, 09:00–17:30 EET)

When you write in, please include your operating system, and the browser version you used for setup. That triages a setup question much faster than a screenshot.