---
title: How to set up your Luxafor Signal light
description: "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. --- ## In this article - Before you start - Configure your…"
url: "https://luxafor.com/help/manuals/luxafor-signal-setup/"
updated: "2026-11-16"
category: Manuals
---

# 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.

---

## In this article

- Before you start
- Configure your Signal for the first time
- Adding audio files to your device
- Configuration mode vs Remote mode — which one to use
- Common issues
- Where to go next
- Need more help?

---

## Before you start

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

1. **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.
2. **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.
3. **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](https://www.luxafor.app/).

---

## Configure your Signal for the first time

#### Step 1 — Open the Luxafor web app

1. In Chrome (or another Chromium browser), go to [luxafor.app](https://www.luxafor.app/).
2. Sign in or create an account.
3. Click **Add Device** in the top-right corner.
4. Select **Signal** from the list of device types.
5. 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*](#configuration-mode-vs-remote-mode--which-one-to-use)*below.)*

#### Step 2 — Connect your Signal over USB

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

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

If your device doesn't appear in the list, see [Common issues](#common-issues) at the bottom of this article.

#### Step 3 — Choose your Wi-Fi network

Once the device connects with the configurator:

1. Wait for Signal to scan for available networks.
2. 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.
3. 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](https://www.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

1. Open [luxafor.app](https://www.luxafor.app/) and sign in.
2. Either configure a new device using the steps above, or select an already-configured device from your dashboard.
3. Open the device's settings. You'll see a list of files currently on the device and an option to upload new ones.
4. 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](https://luxafor.com/help/integrations/how-to-connect-your-luxafor-signal-to-shopify/) or your [custom cloud API integration](https://luxafor.com/help/developers/how-to-build-signal-integration-through-cloud-api/).

> **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

1. 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_` ).
2. On the new computer, open [luxafor.app](https://www.luxafor.app/) and click **Add Device** → **Signal** → **Remote**.
3. 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

#### My Signal isn't appearing in the browser popup

- 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**](https://luxafor.com/help/integrations/how-to-connect-your-luxafor-signal-to-shopify/) — connect new-order alerts and other Shopify events to your Signal.
- [**How to build a Signal integration through the cloud API**](https://luxafor.com/help/developers/how-to-build-signal-integration-through-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](mailto: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.
