Dashboard Not Updating

Your OceanRemote dashboard shows stale data, relay states don't change, or temperature readings don't refresh. The page loads but real-time updates are frozen. This guide covers browser cache issues, JavaScript errors, polling problems, network connectivity, and server-side delays.

Last updated: April 22, 2026 | 10 min read

Symptoms

• Dashboard loads but device status never changes from "Offline"
• Temperature readings frozen
• Clicking relay buttons has no effect on dashboard display
• Other devices update normally but specific device doesn't
• Dashboard works on one browser but not another
• Page refresh shows updated data but auto-refresh doesn't work
• Browser console shows JavaScript errors

Common Causes

1. Browser Cache Issue Old JavaScript or CSS cached by browser preventing updates
2. JavaScript Error in Console Syntax error or missing function breaking auto-refresh
3. Device Not Sending Data Device offline or not polling server
4. Polling Interval Blocked setInterval() blocked by browser throttling
5. Network Connectivity Issue Firewall or proxy blocking API calls to /api/debug-data/
6. Server-Side Lag High server load causing delayed responses
7. Browser Extension Interference Ad blocker or privacy extension blocking fetch requests

Dashboard Update Mechanism

OceanRemote Dashboard Update Flow:

1. Page loads  displays initial device data from Django template
         
         
2. JavaScript starts setInterval() every 5000ms 
         
         
3. fetch() calls /api/debug-data/ endpoint
         
          Network error  Retry after 5 seconds
         
         
4. Server returns JSON with current device states
         
         
5. JavaScript updates DOM elements:
   - Relay button states 
   - Temperature readings
   - Device status 
   - Last seen timestamps
         
         
6. Loop repeats every 5 seconds

Step-by-Step Fixes

1. Hard Refresh Browser

Clear cached JavaScript and force reload:

• Windows/Linux: Ctrl + F5 or Ctrl + Shift + R
• Mac: Cmd + Shift + R
• Or: Clear browser cache completely
• After hard refresh, dashboard should start updating
• If issue persists, try incognito/private mode

2. Check Browser Console for Errors

JavaScript errors break auto-refresh:

// Open Developer Tools:
// Chrome/Edge: F12  Console tab
// Firefox: Ctrl+Shift+I  Console tab
// Safari: Cmd+Option+C  Console tab

// Look for red error messages:
//  "Uncaught ReferenceError: xxx is not defined"
//  "Failed to fetch" or "NetworkError"
//  "TypeError: xxx is not a function"

// Common errors and fixes:
// "fetchDeviceData is not defined"  Reload page, clear cache
// "Failed to fetch"  Check network connectivity
// "403 Forbidden"  CSRF token issue, refresh page

3. Verify Device is Sending Data

Dashboard only updates if device sends data:

• Check device status icon should be ONLINE
• If status is OFFLINE or AWAY , device is not communicating
• Open Serial Monitor on device
• Look for: [UPDATE] Sending temperature: XX.XC
• If no messages, device is not polling check WiFi and power

4. Test API Endpoint Directly

Check if data endpoint is accessible:

// In browser, navigate to:
https://www.oceanremote.net/api/debug-data/

// Should return JSON like:
{
  "total_devices": 2,
  "devices": [
    {"id": "ESP32_XXX", "status": "online", "temperature": 22.5, ...}
  ]
}

// If you see:
// - JSON data  API working, issue is frontend JavaScript
// - 404 error  API endpoint not found
// - 500 error  Server error, contact support
// - Empty response  No devices, add device first

5. Disable Browser Extensions

Ad blockers can block fetch requests:

• Temporarily disable ad blockers
• Disable privacy extensions
• Disable script blockers
• Test in incognito/private mode
• If dashboard works in incognito, an extension is the cause
• Add oceanremote.net to extension whitelist

6. Check Browser Tab Activity

Browsers throttle setInterval() in inactive tabs:

• Some browsers reduce timer frequency to 1-2 seconds per minute for background tabs
• Keep dashboard tab active for real-time updates
• Switch to dashboard tab and wait 10-15 seconds
• If using multiple monitors, keep tab visible
• Consider using Page Visibility API

7. Test with Different Browser/Device

Isolate browser-specific issues:

• Try Chrome, Firefox, Edge, or Safari
• Test on mobile device
• If dashboard updates on other browser, issue is browser-specific
• Clear cache and cookies on problematic browser
• Reset browser settings to default if needed

Common Console Errors and Fixes

Console Error	Cause	Solution
Failed to fetch ()	Network error, CORS, or server down	Check internet connection, disable VPN/proxy
Uncaught ReferenceError: xxx is not defined ()	Missing JavaScript function	Hard refresh to reload scripts ()
403 Forbidden ()	CSRF token missing or invalid	Refresh page to get new CSRF token ()
net::ERR_CONNECTION_REFUSED ()	Server not responding ()	Check server status, try again later (,)
SyntaxError: JSON.parse	Server returned HTML instead of JSON	Check if logged in, API endpoint correct

Prevention Tips

• Hard refresh after firmware updates or dashboard changes
• Keep dashboard tab active for real-time updates
• Add oceanremote.net to ad blocker whitelist
• Use modern browsers
• Clear browser cache monthly to prevent stale JavaScript
• If using VPN, ensure it doesn't block API endpoints
• Monitor browser console for errors when dashboard behaves unexpectedly

Related Issues

• Device Offline in Dashboard
• Device Away Status Explained
• ESP32 Not Connecting to WiFi
• Session Expired Too Fast

Frequently Asked Questions

Still having dashboard issues? Contact Support or return to the Troubleshooting Hub.