Setup and Wi-Fi problems

Find the section that matches what you see. Check your network against Wi-Fi and network requirements first, because it rules out several of these before you start.

The QR code will not scan

The setup screen rotates between views, so the code can leave the screen before your camera locks on. Camera distance matters too.

1. Power-cycle the display, then try again while the code is on screen.
2. Stand further back. Phone cameras struggle with LED panels up close, and Android cameras need more room than iPhone cameras. Step back until the whole code fits in frame.
3. Photograph the panel while the code is visible, then scan the photo from your camera roll.
4. Switch to Enter Manually and type the device code and password.

For manual entry, the code is the part of the Wi-Fi name after Flightwall-. Photograph the panel and read from the photo. 0 and O look alike on an LED grid, as do 1 and l.

The app cannot find or hold the display

The display's Wi-Fi does not appear, drops out of the list, or the app reports a connection failure, a timeout, or that a device is already connected.

1. Power-cycle the display. Unplug it for up to 30 seconds.
2. Open your phone's Wi-Fi settings, outside the app, and look for the Flightwall- network. If it is there, join it with the password on the panel, then return to the app and carry on.
3. Forget the Flightwall- network on your phone, then retry from the app.
4. Update the TheFlightWall app.
5. If the app insists a device is already connected, remove the display from the app, reinstall the app, and start setup again from a fresh power cycle.
6. Try a second phone or tablet if you have one.

Collect the Device ID, app version, phone model, and a photo of the setup screen before you report it.

The display's password is rejected

Your phone says the password is wrong even though you copied it carefully, or the Flightwall- network blinks in and out of the Wi-Fi list.

1. Restart the display and try again.
2. Forget the Flightwall- network on your phone first.
3. Join the network from your phone's Wi-Fi settings rather than from the app.
4. Try a second phone or tablet.

Newer displays use an eight-character password. Older displays use Flight- followed by the device code. The app accepts either.

If more than one phone rejects the password, or the network will not stay visible long enough to join, report it with the Device ID and a photo of the password screen.

Network check failed

After joining Wi-Fi, the display checks it can reach the internet by contacting cdn.theflightwall.com. This message means the network allowed the Wi-Fi connection but blocked that check.

1. Test on a phone hotspot. If the display works there, the problem is the original network, and the display can pull any waiting software update while it is connected.
2. Turn off local DNS caching on your router.
3. Set the router to a public DNS resolver: 8.8.8.8 with 8.8.4.4, or 1.1.1.1 with 1.0.0.1.
4. In any router security suite or parental controls, allow theflightwall.com, cdn.theflightwall.com, and api.theflightwall.com. Check the display is not paused or blocked as a device.
5. Create a guest network and put the display on that. This clears most of the remaining cases.

Mesh systems are the most common cause. Work through the steps in order rather than trying them all at once, so you know which one worked.

The display joins Wi-Fi then returns to the setup screen

The app reports success, or the panel briefly shows a connected state, then the display goes back to the QR code or the setup instructions.

Nearly always the network allows the Wi-Fi connection but not the internet access the display needs.

1. Confirm the network is 2.4 GHz with WPA2. The display cannot use 5 GHz, WPA3, or a network with a browser sign-in page.
2. Test on a phone hotspot or a guest network that only needs a password.
3. If it works there, leave it connected long enough to finish any software update, then try your main network again.
4. Follow the DNS and security steps under Network check failed above.
5. On a workplace or campus network, ask the administrator for a password-only device network, or for the display's MAC address to be allowed through. Find the address under System.

The display keeps dropping off Wi-Fi

It worked, then started disconnecting, or returns to setup every few days.

1. Unplug the display for about ten seconds and plug it back in, so it reconnects cleanly and applies any waiting update.
2. Update the app.
3. Reconnect it to the network it last worked on, so it can pull updates.
4. Test whether the same thing happens on a different network or a hotspot. If it does not, the original network is contributing.
5. If the app itself is confused and shows no display, remove and reinstall the app, then add the display back.

Report it with the Device ID, your firmware version, the network type, and how often it happens.

The setup screen is back but the display is still in the app

You do not have to rebuild the configuration.

Reconnect through the app by scanning the QR code on the panel or using manual connection, and finish Wi-Fi setup. The display's saved settings come back with it.

If the display still shows as connected in the app, try Change Wi-Fi Network on the System page instead. Do not factory-reset it unless you want to start over.

The display reboots or the screen flashes during startup

An underpowered supply causes this. The display draws more current than a spare phone charger provides.

1. Use the adapter that came with the display.
2. If you must use another, the FlightWall Mini needs a USB-A adapter rated at 2 A or higher. The supplied brick is 5 V and 3.4 A.
3. Restart the display after changing the supply and run setup again.

If it still reboots while using the supplied adapter, report it with the Device ID and a description of what the panel does.

Setting up on a network you do not control

A hotel, cafe, campus, or office network with a sign-in page cannot work. The display has no browser and cannot accept terms.

Ask the network administrator for one of these:

• A password-only network for devices, often called an IoT network.
• Permission for the display's MAC address, from System in the app.

The abnormal first-power-on screen

On first power-up the panel should show setup information and a QR code. Rolling foreign characters, garbled text, or a date and time instead mean the unit did not leave the factory correctly, and there is no way to connect to it.

Power-cycle it once. If the same screen returns, stop troubleshooting and contact contact@theflightwall.com with your order number and a photo or short video of the panel. The unit needs replacing.