Skip to main content
Optimaatti
← Back to help

Troubleshooting

Start with the quick checklist below. Most problems are caused by a small setting mistake.

If control worries you, stop it first

Troubleshooting is easier when automation is not changing the device state at the same time. You can always return to manual control and continue calmly.

Stop automationContact support

Start with these checks

  • Device online? Can you open the device web UI from your home network (by IP)?
  • Device connection on? Is the device connection enabled and does it show ?Connected??
  • Correct connection details? Host/port/user/password copied from Optimaatti connection details page.
  • TLS/SSL matches port? If TLS/SSL is enabled, use the TLS port shown by Optimaatti; otherwise use the open port.
  • Unique device ID? The same clientId on multiple devices can break connections. Keep it unique if the device lets you edit it.
Device connection guideBackup schedulesRulesPredictive heating

Decision tree: what problem do you have?

  • Device does not appear at all: usually connection details, TLS/port or network.
  • Device appears but is offline: connection drops, wrong port, wrong connection details, or internet issues.
  • Device online but does not react: commands not reaching device or rules overriding.
  • Predictive heating / Learning behaves oddly: sensor placement, data gaps, tight limits or wrong power.
  • Backup schedules not working: device does not support them, no schedule was created, or sync failed.

Device does not appear in the system

Follow these steps to resolve the issue

1

Check device connection settings

  • Open the device web UI
  • Go to Settings → Advanced → MQTT
  • Ensure the device connection is enabled
  • Copy host/port/user/password from Optimaatti connection details page
  • Ensure TLS/SSL setting matches the chosen port
  • Keep the device ID (clientId) unique if the device lets you edit it
2

Check network connectivity

  • Ensure the device has internet access
  • Try pinging the device (e.g. ping 192.168.1.100)
  • Ensure firewall/router does not block the device connection
3

Restart the device

  • Power off for 10 seconds
  • Power on
  • Wait ~30 seconds
  • Check if the device appears in the dashboard

Predictive heating does not behave as expected

Follow these steps to resolve the issue

1

Check target temperature and limits

  • Open device settings
  • Ensure min/max are realistic (e.g. 21–23°C)
  • Too narrow range can cause frequent toggling
2

Check device type and sensor

  • Ensure correct device type is selected
  • Ensure temperature readings are realistic
  • Verify sensor placement (no sun/drafts/near heater)
3

Allow the system to learn

  • During the first days predictive heating may need time to adapt
  • Monitor for a few days before conclusions
4

Check price data

  • Verify spot prices update normally
  • If prices are missing, predictive heating may fall back to a backup plan

Device shows as offline

Follow these steps to resolve the issue

1

Check device status

  • Open device web UI
  • If you cannot access it, the device is truly offline
  • Check power and network cable
2

Check device connection

  • Open device connection settings
  • Check connection status
  • If disconnected, verify the server address, username and password
3

Regenerate device connection password

  • If it used to work, regenerate password in Optimaatti
  • Update the new password in the device connection settings

Device does not react to commands

Follow these steps to resolve the issue

1

Check status

  • Ensure device is online
  • Refresh the page
  • Ensure you have permission to control the device
2

Try manual control

  • Open device web UI
  • Toggle on/off there
  • If it works, issue is the Optimaatti connection; if not, issue is the device
3

Check rules

  • A rule may override manual control
  • Review active rules
  • Temporarily disable rules to test

Backup schedules not working

Follow these steps to resolve the issue

1

Ensure backup schedules are enabled

  • Open device settings in the dashboard
  • Enable backup schedules
  • Save
2

Check device support

  • Not all models support backup schedules
  • Supported: Shelly Plus and Pro
  • Gen1 does not support it
  • Requires schedule generation and successful sync
3

Update firmware

  • Open device web UI
  • Go to Settings → Firmware
  • Update to latest
  • Restart after update

Price data does not update

Follow these steps to resolve the issue

1

Check ENTSO-E API

  • Prices come from ENTSO-E API
  • API may be temporarily down
  • Wait 15 minutes and try again
2

Check timezone

  • Open Settings → General
  • Ensure timezone is correct (Europe/Helsinki)
  • Save

Still not solved?

Contact support and we'll help you personally.

Contact usView FAQ