Device management

What the device connection means

This connection lets the device send data to Optimaatti and receive control back. Shelly calls this setting MQTT, but you do not need to learn the protocol: the important part is copying the correct values into the correct fields.

Before you start

• -Make sure the device is on the same home network as your phone or computer.
• -Open the connection details in Optimaatti before you start editing the device.
• -Copy values directly from Optimaatti. One typo is enough to break the connection.
• -If the device has a TLS/SSL setting, use it together with the matching port.
• -Start with one device first and add more only after the first one works.

TLS/SSL and the port

Think of these as a pair: if TLS is enabled, use the matching port. If TLS and the port do not match, the connection will fail.

Configure device connection (web UI)

1. Open the device web UI (e.g. Shelly) using its IP address
2. Go to device connection settings (Settings → Advanced → MQTT or similar)
3. Enable the connection (`Enable MQTT`)
4. Verify TLS/SSL setting and matching port
5. Open the "Connection details" page in Optimaatti
6. Copy host, port, username and password
7. Paste values into device connection settings exactly
8. Save and reboot the device if prompted

Always get host, port, username and password from Optimaatti "Connection details".
Do not use example placeholders.

Common connection fields and what they mean

• -Host: server address. Copy as-is from Optimaatti.
• -Port: copy the exact port Optimaatti shows. TLS/SSL and open connections use different ports.
• -Username and password: copy both from Optimaatti. A wrong password prevents the connection.
• -Unique device ID (clientId): keep it unique if the device lets you edit it. Two devices with the same ID can disconnect each other.
• -Connection keepalive: keep the default if the device has this setting.

Set up Shelly without the Shelly App

1. The easiest way without the Shelly app is to add the Shelly directly with the Optimaatti app over Bluetooth (Gen2 and newer) — it sets the Wi-Fi and the Optimaatti connection in one go. The browser/access-point method below is the manual alternative for older devices.
2. Power the Shelly device (wiring by a qualified electrician where required)
3. Wait for Shelly to create its own Wi-Fi network (e.g. "shellyplus1-XXXXXX")
4. Connect your phone/computer to that Wi-Fi network
5. Open http://192.168.33.1
6. Select your home Wi-Fi (SSID) and enter password
7. Save — Shelly joins your home Wi-Fi
8. Find the Shelly IP in your router and open its web UI (e.g. http://192.168.1.123)
9. Open device connection settings (Settings → Advanced → MQTT)
10. Enable the connection and enter the connection details from Optimaatti
11. Save and wait for the device to appear in Optimaatti Devices view

Where do I find connection details?

You can find the connection details in the Optimaatti dashboard under Connection details. Each user has their own connection details.

Shortcut: I just want one device to appear quickly

1. Open the connection details in Optimaatti.
2. Turn the connection on in the device settings.
3. Paste the values and save.
4. Open Devices in Optimaatti and wait a moment.
5. If the device does not appear, check the port, TLS and password first.

How do devices appear in the system?

When a Shelly device is connected to Optimaatti, it announces itself automatically. Optimaatti detects it and adds it to the dashboard in seconds.

What information does the device send?

• -Device model
• -MAC address
• -IP address
• -Firmware version
• -Number of channels
• -State (on/off)
• -Power usage (if supported)

If the model is not detected automatically

If model detection fails, you can set the model on the device edit page. This matters because it determines how many outputs/channels the device has and how control is mapped.

Device metadata: type, purpose and metering

After the device appears, open its settings and fill in key metadata. This affects where the device appears and how reports are calculated.

• -Device type: affects number of channels/outputs and how the device is controlled.
• -Purpose: helps interpretation (Heating vs Lighting vs Outlet/relay).
• -Energy metering: only metering devices appear in cost analysis.
• -This device is a heater + nominal power (W): used for forecasting and reporting.
• -Temperature sensor: link a sensor to improve heating logic and away coverage.

Renaming a device

You can rename devices in the dashboard. Click the device name and enter a new one.

Rooms and groups

Organize devices into rooms and light groups. Create rooms in the Rooms view and add devices. Inside rooms you can create light groups and assign one or more devices.

Sensors and controlling light groups

1. Open the room page in the Rooms view.
2. Create a light group if needed and add lights.
3. Add a sensor and select which device/input provides the sensor data.
4. Link the sensor to the light group you want it to control.
5. Use sensors and light groups together with rules for automation.

Manual control

You can always control devices manually from the dashboard regardless of rules.

Device type and purpose (why they matter)

1. Open a device in the Devices view and edit details
2. Select device type so Optimaatti knows how many outputs it has and how control maps
3. Select purpose (Heating, Lighting, Ventilation, Outlet/relay) for better grouping and automation

Energy metering

If the device supports energy metering (PM models), enable it. Only metering devices appear in cost analysis and reports.

Heater device and nominal power (W)

If the device controls heating, mark it as a heater and enter nominal power (W). This is used for heating cost forecasting.

Link a temperature sensor

If a heater has no own temperature, link a separate sensor device. This improves temperature-based logic and away coverage.

What are demo devices?

Demo devices are virtual Shelly devices that let you try Optimaatti without controlling any physical devices. They use real spot prices and the same rule and predictive heating logic as real devices.

Add a demo device

1. Sign in and open the Dashboard.
2. Find the "Add demo device" card.
3. Select a demo device type.
4. Click "Add demo device".
5. Open Devices view — the demo device appears with a DEMO label and can be used with rules like real devices.

Limitations

• -Demo devices never control any physical relay/heating — they are fully virtual.
• -You can create only a limited number to keep the UI clear.
• -You can reset the whole demo environment and start again.

Device does not appear

• -Confirm the device connection is enabled
• -Confirm the server address was copied from Optimaatti correctly
• -Check the port and make sure the TLS/SSL setting matches the port shown by Optimaatti
• -Re-copy username and password from Optimaatti
• -Confirm the device is online and has internet access
• -Wait 1–2 minutes and refresh Devices view
• -If the device appears twice or disappears, check that another device is not using the same device ID (clientId)

Device shows offline

• -Check internet connectivity
• -Confirm the connection server is reachable
• -Restart the device
• -Confirm the device connection password has not expired
• -Check router/firewall settings that may block outbound connections

Device does not react to commands

• -Confirm the device is online
• -Confirm you have rights to control the device
• -Try manual control in the device web UI
• -Update device firmware
• -For multi-channel devices, confirm you are controlling the correct channel

If the issue persists

If you have checked the above and the device still does not appear or stays offline, open troubleshooting for a more detailed checklist.