Display Not Loading or Configuration Error

If your LobbyFlight display does not load or shows a configuration error, follow these troubleshooting steps.

Common Error Messages

You may see one of these messages:

"Configuration Error - Unable to load display configuration"

"Hotel not found, using default config"

Red error screen with WifiOff icon and "Retry" button

Infinite loading with animated airplane icon

Blank white screen

Quick Checks (2 Minutes)

Before deeper troubleshooting, check these most common causes:

1. Check Internet Connection

# Test on the display device:
ping google.com
# or
ping lobbyflight.com

Expected result: Packets should arrive (0% packet loss)

If connection is missing:

Check WiFi connection

Test ethernet cable

Restart router

→ See article "Network Configuration"

2. Verify Display URL

Correct URL:

https://lobbyflight.com/display/[your-hotel-id]

Example:

https://lobbyflight.com/display/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Common errors:

/portal instead of /display

localhost:3000 (development URL)

Missing or incorrect hotel ID

Spaces in the URL

Solution:

Navigate to: Preview → Copy Display URL

Or: Scan QR code from the portal

3. Clear Browser Cache

Chrome on Android:
1. Settings → Apps → Chrome
2. Storage → Clear cache
3. Clear browsing data
4. Reload display URL

Cause 1: Missing or Invalid Hotel Configuration

Technical Details

Code location: /app/api/config/[hotelId]/route.ts (lines 47-54)

The display loads your hotel configuration via the API:

GET /api/config/[hotelId]

Fails when:

Hotel ID does not exist in the database

Database connection failed (POSTGRES_URL not set)

Hotel was deleted or deactivated

Symptoms

Error screen with red background

Console error: "Failed query: select ... from hotels where id = $1"

Infinite loading spinner

Solution

Step 1: Verify hotel ID is correct

# Your hotel ID from the portal URL:
https://lobbyflight.com/portal/dashboard
# Hotel ID is visible in the browser address bar or in settings

Step 2: Check if hotel is active

Navigate to Settings

Check: Is the hotel marked as "Active"?

Step 3: Check browser developer console

1. Open display URL in browser
2. Press F12 (Developer Tools)
3. Tab: Console
4. Look for red error messages

Cause 2: Network/Firewall Blocking

Technical Details

The display requires access to:

`lobbyflight.com`	443	Main application
Domain	Port	Purpose
--------	------	---------
`*.supabase.co`	443	Database (if applicable)
`aviationstack.com`	443	Flight data API

Symptoms

Loading takes very long

"Network Error" in console

Display works on phone but not on display device

Solution

Step 1: Test connectivity

# Test if domains are reachable:
curl -I https://lobbyflight.com
curl -I https://api.aviationstack.com

Step 2: Configure firewall

Allow outbound connections:
- Protocol: HTTPS (TCP 443)
- Domains: lobbyflight.com, *.supabase.co, aviationstack.com

Step 3: Check proxy settings

Disable proxy settings in the browser

Or configure the proxy correctly for HTTPS

Cause 3: Browser Compatibility

Supported Browsers

Chrome	90+	Recommended
Browser	Version	Status
---------	---------	--------
Edge	90+	Supported
Firefox	88+	Supported
Safari	14+	Limited

Symptoms

Display looks broken

Features not working

JavaScript errors in console

Solution

Recommendation: Use Google Chrome in kiosk mode

# Start Chrome in kiosk mode:
chrome --kiosk "https://lobbyflight.com/display/[hotel-id]"

Cause 4: SSL/HTTPS Problems

Symptoms

"Your connection is not private" warning

SSL certificate errors

Mixed content warnings

Solution

Step 1: Check system time

Wrong system time causes certificate errors!
- Check date and time on the device
- Enable automatic time synchronization

Step 2: Update CA certificates

# On Linux/Android:
update-ca-certificates

Emergency Solution: Offline Mode

If nothing works, the display has an offline mode:

Automatic Offline Mode

The display automatically caches flight data. When the connection is lost:

Last cached data is displayed

"Offline" indicator appears

Automatic retry every 30 seconds

Manual Refresh

1. Press F5 (or Ctrl+R)
2. Or: Touch screen and swipe down (Android)
3. Or: Click "Retry" button

Still Not Working?

Collect Diagnostic Data

Before contacting support, collect:

Screenshot of the error

Browser console (F12 → Console tab)

Network tab (F12 → Network tab → reload page)

Device info: Browser version, operating system

Hotel ID (from portal URL)

Contact Support

With the diagnostic data:

Email: info@lobbyflight.com

Or: Contact form in the portal

Related Articles:

Generate Display URL and Use QR Code

Network Requirements and Firewall Configuration

Set Up Android Display (Chrome Browser)

Display Not Loading or Configuration Error