Quick Start

Overview

DecentIoT (Decent-iot) is a truly decentralized and database-agnostic IoT platform, where user brings their own databases to power their IoT applications.

What “DecentIoT” means?

• Decent → not just a name, but a statement. Unlike conventional IoT platforms that are restricted by centralization, DecentIoT is built to be genuinely decent—open, flexible, and free from those limitations.

• IoT → a complete Internet of Things platform that empowers developers, businesses, and communities to build and scale without boundaries.

Together, DecentIoT stands for a truly decent IoT platform—the kind the community has been waiting for.

---

Try it out!

Follow the quick start guide below to create a project, connect a device, and toggle an LED from the DecentIoT dashboard — all within 5 minutes.

Requirements

• A DecentIoT account. Register from DecentIoT Deck

• A device or simulator (ESP32 recommended; Wokwi is fine for simulation)

• Either a Firebase Realtime Database project or an MQTT broker (we recommend MQTT for simple device connectivity, HiveMQ Cloud works well)

• Basic knowledge of Arduino / PlatformIO (for firmware)

Setup flow (5-minutes)

After sign up / log in at DecentIoT Deck:

• Create a new Project → give it a name (e.g., my-first-iot).

• Provider: choose MQTT (recommended) or Firebase.

  • If MQTT: create HiveMQ cluster (see MQTT guide) and copy host/port/username/password into Project Config.

  • If Firebase: create a Firebase project and copy web SDK config into Project Config (see Firebase guide).

• Create a Dashboard in your project — add one “Toggle” widget named led1. Save.

• On Device: flash the sample MQTT sketch (see library examples) with the projectId and deviceId. Device will subscribe to decentiot/<projectId>/<deviceId>/fromServer.

• In the Web dashboard press the led1 toggle → device receives the command and toggles physical/simulated pin → dashboard reflects state.

If that worked: 🎉 You’re live! Continue reading the detailed sections for full setup and advanced workflows.

For detailed guidance on integrating Firebase and MQTT, including how to retrieve necessary credentials, please check out the dedicated Firebase Setup Guide and MQTT Broker Guide guides.

Please note: The provided sources do not contain information on how to retrieve credentials specifically from HiveMQ for Firebase or MQTT setup. This information would need to be sourced externally for those sections.