Troubleshooting Jellyfish Lighting: Common App Connection Issues

Start by checking the controller's connection status

Open the app and check whether your controller shows as online or offline. This single check tells you whether the problem is at the network level or somewhere else, like a specific scene not applying correctly.

If the controller shows offline, the issue is almost always related to Wi-Fi rather than the physical lighting hardware. If it shows online but scenes still are not applying, the issue is more likely with a specific scene or zone configuration.

This first step saves time by narrowing down whether you are dealing with a connectivity problem or something more specific to a particular scene.

Common causes of a controller going offline

Router reboots, especially ones triggered by an internet provider or a scheduled restart, sometimes assign the controller a new IP address that breaks the existing connection until it reconnects on its own or is manually reset in the app.

Wi-Fi password changes are a frequent cause, since the controller needs to be manually reconnected with the new password through the app rather than updating automatically.

Router firmware updates or a full router replacement can also require re-pairing the controller from scratch, similar to setting up any other smart home device on a new network.

Basic restart steps that fix most issues

Power cycling the controller, by unplugging it for about 30 seconds and plugging it back in, resolves a surprising number of stuck or unresponsive states. This is the same principle as restarting a router when internet stops working.

Closing and reopening the app fully, rather than just backgrounding it, clears out cached connection states that sometimes cause scenes to appear stuck even when the controller itself is fine.

If both of those do not help, checking for an available app update in your phone's app store is worth doing next, since older app versions occasionally have known bugs that get fixed in updates.

• Confirm controller status shows online in the app
• Power cycle the controller by unplugging for 30 seconds
• Fully close and reopen the app rather than backgrounding it
• Check for and install any available app updates
• Re-enter Wi-Fi credentials in the app if the network password recently changed

When a specific scene will not apply correctly

If the controller shows online but a specific scene does not apply as expected, the issue is more likely with that individual scene's settings than a connectivity problem. Try applying a different, simpler scene first to confirm the system responds at all.

Sometimes a scene built before an app update behaves differently after the update changes how certain effects render. Rebuilding the scene from scratch after an update usually resolves this.

If only one zone within a multi-zone setup misbehaves while others work fine, that points toward a wiring or zone-specific issue rather than a general app problem, which is worth reporting directly.

Network setup issues that cause recurring problems

Homes with mesh Wi-Fi systems sometimes have the controller bouncing between different access points, which can cause intermittent connection drops. Setting a preferred access point or checking your mesh system's device management settings can stabilize this.

Guest networks or networks with client isolation enabled can prevent the app on your phone from communicating with the controller even though both are technically online, since client isolation blocks devices on the same network from talking to each other.

If you recently changed internet providers or replaced your router entirely, plan on a short re-pairing process for the controller, similar to setting up a smart thermostat or security camera on new hardware.

When to stop troubleshooting and reach out

If basic restarts, app updates, and network checks do not resolve the issue, it is more efficient to reach out directly than to keep repeating the same steps. Note what you have already tried so any support conversation can start from where you left off.

Physical hardware issues, like a section of track that will not light no matter what scene is applied or how the controller is reset, are different from software issues and worth flagging clearly as such.

As your authorized dealer, we can help sort out whether an issue is on the network side or something that needs an in-person look.

Frequently asked questions