Skip to content

Performance Tips

JP IT edited this page Jan 22, 2026 · 1 revision

Performance Tips

Real-Time Mode Selection

Use the appropriate real-time mode for your openHAB version:

openHAB Version Recommended Mode Config Setting
1.x / 2.x Atmosphere server.websocket.mode = 'atmosphere'
3.x / 4.x / 5.x SSE server.websocket.mode = 'sse'
Any (fallback) Polling server.websocket.mode = 'polling'

Slim Mode

Enable slim mode for embedded displays or low-power devices:

https://your-proxy.com/?slim=true

Slim mode features:

  • Reduced polling intervals (configurable via pollIntervalsMs.slim)
  • Native selection overlays instead of custom dropdowns
  • Minimal UI chrome

Polling Intervals

Tune polling intervals based on your network and use case in config.local.js:

client: {
  pollIntervalsMs: {
    default: { active: 2000, idle: 10000 },  // Normal mode
    slim: { active: 10000, idle: 20000 },    // Slim mode
  },
  idleAfterMs: 60000,  // Time before switching to idle polling
}

Service Worker

Enable HTTPS for service worker support, which provides:

  • Offline resilience
  • Faster asset loading from cache
  • Background sync capabilities

Delta Updates

ohProxy uses delta updates to minimize bandwidth. Only changed fields are transmitted to the client, reducing network overhead for large sitemaps.

Browser Support

For best performance, use modern browsers:

  • Chrome/Edge 80+
  • Firefox 75+
  • Safari 13+
  • iOS Safari 13+
  • Android Chrome 80+

Clone this wiki locally