> For the complete documentation index, see [llms.txt](https://mugic-motion.gitbook.io/mugic-r-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mugic-motion.gitbook.io/mugic-r-documentation/getting-started-hub/troubleshooting.md).

# Troubleshooting

### Common Troubleshooting Issues

#### 1. 🟣 LED 3 Blinking Purple = It's in Client Mode

<figure><img src="/files/WbMT79PyEJv0YKFPEwjd" alt=""><figcaption><p>Solution: ‘Long Press’ “M” button. The third LED will turn SOLID blue, indicating that it is ready to connect. Follow Step 2 and connect MUGIC to a Wi-Fi Network.</p></figcaption></figure>

#### 2. 🔵 LED Blinking Blue and computer is connected to MUGIC but the data isn't working = It's in USB mode.

<figure><img src="/files/BFQvMrkGdMfxpwMod0lp" alt=""><figcaption><p>Solution: ‘Tap’ M button twice. The third LED will turn SOLID blue, indicating that it is ready to connect. If it turns purple, see “Common Issue 1”.</p></figcaption></figure>

### Client-mode connection quick fixes

If MUGIC® won't join your Wi-Fi network in Client mode, check these first:

* **Use a 2.4 GHz network.** MUGIC® cannot see or join 5 GHz networks. On an iPhone hotspot, turn on Settings → Personal Hotspot → "Maximize Compatibility". This is the most common cause.
* **The "Success" popup only means "saved," not "connected."** Power-cycle MUGIC® after configuring, then confirm: *fast blinking purple* = still trying; *slow, steady blinking purple* = connected and streaming.
* **Still seeing `MugicConnectXXXXXX`?** If MUGIC®'s own network reappears after restart, it failed to join yours — recheck the network name/password and the 2.4 GHz requirement.
* **Connected but no data?** Set the Client IP to your computer's IP address, match the port (default 4000), and make sure your computer's firewall isn't blocking incoming UDP.
* **Password too long?** MUGIC® supports Wi-Fi passwords up to 63 characters; shorten it or use a different 2.4 GHz network.

For more detail, see the [Frequently Asked Questions](/mugic-r-documentation/frequently-asked-questions.md).
