Add your first device

  1. Go to Devices → Add Device.

  2. Give it a name and location label, then choose a protocol based on how it connects:

    • It has its own internet connection and speaks MQTT → mqtt-direct.
    • It's a Modbus/RS485 sensor on a gateway → rs485.
    • It's wired to a gateway's pins → a GPIO, I²C, SPI, 1-Wire or UART device.
    • It's polled over the network → HTTP.
    • It pushes readings over plain HTTPS (no MQTT client — scripts, cloud functions, firewalled devices) → Webhook (HTTP push).

    Some protocols shown in the picker — Modbus TCP, SNMP, CAN Bus and M-Bus — are marked coming soon while they finish hardware verification. You can't create devices with them yet; check the roadmap for status.

  3. Fill in the connection fields for that protocol and define your tags (the measurements to read).

  4. Save. For mqtt-direct, copy the credentials shown once on creation — you'll need them on the device. For Webhook, the endpoint URL and secret appear on the device's page right after creation.

New to the device model? Read devices vs. gateways first.