IoTSharp

April 18, 2026 · View on GitHub

IoTSharp

Docker Pulls GitHub all releases

IoTSharp is an open-source industrial IoT platform for device access, telemetry collection, rule-chain processing, visualization, multi-tenant operations, and product delivery.

🚀 Overview

IoTSharp brings together the core building blocks needed to run an IoT platform in production:

Device and gateway connectivity with HTTP, MQTT, CoAP, and extensible protocol integration.
Telemetry, attributes, alarms, products, assets, and tenant-aware management models.
Rule-chain driven processing for transformation, notification, automation, and business actions.
Relational and time-series storage options for different deployment and scaling needs.
Multiple delivery modes including Docker, Windows service, Linux service, installer flows, and release artifacts.
The roadmap now also treats AI workbench, MCP tools, and agent-assisted operations as a cross-cutting capability for collection, rules, and release workflows.

The current main application targets .NET 10, and the web console is maintained as an IoTSharp-branded Vue 3 application.

🧭 Quick Start

🖥️ Run IoTSharp locally

The recommended documentation entry points are:

Product docs: https://iotsharp.net/docs/intro
Installation options: https://iotsharp.net/docs/getting-started/installation-options
Installer guide: https://iotsharp.net/docs/getting-started/installer
Docker Desktop extension: https://iotsharp.net/docs/deployment/docker-desktop-extension

For frontend development, the current local dev server default is:

Frontend: http://localhost:27915

🤖 Use OpenClaw for AI-assisted SQLite setup

If you want OpenClaw to guide you through creating a local SQLite-based IoTSharp instance, start with:

https://iotsharp.net/docs/operations/openclaw-sqlite-runbook
Prompt template: tools/prompts/openclaw-sqlite-instance.txt

The runbook defines the SQLite bootstrap flow, installer initialization path, Docker Desktop Extension fallback route, and the safe rule for switching databases later through appsettings.{Environment}.Installer.json.

🧩 Supported Components

Area	Summary
Connectivity	Device, gateway, and protocol integration for industrial access scenarios
Platform domain	Telemetry, attributes, alarms, products, assets, tenants, and users
Data foundation	Relational storage, time-series storage, and installer-driven configuration templates
Integration pipeline	Rule chains, scripting, notifications, event delivery, and automation actions
Delivery modes	Docker, services, installer flows, and Docker Desktop Extension experiences

For the detailed database matrix, time-series options, message middleware support, and configuration examples, see the docs:

📦 Deployment Options

Docker: https://iotsharp.net/docs/deployment/docker
Docker Desktop extension: https://iotsharp.net/docs/deployment/docker-desktop-extension
Windows service: https://iotsharp.net/docs/deployment/windows-service
Linux service: https://iotsharp.net/docs/deployment/linux-service
Application configuration: https://iotsharp.net/docs/configuration/appsettings

Online demo:

https://host.iotsharp.net

🗂️ Repository Structure

Key directories in this repository:

IoTSharp: main ASP.NET Core application.
ClientApp: Vue 3 frontend console.
docs: Docusaurus documentation site.
docker-desktop-extension: Docker Desktop extension experience package.
IoTSharp.Installer.Windows: Windows installer project.
IoTSharp.Agent: planned companion/tray direction for future local desktop and voice experiences; not currently present as a repository directory.
IoTSharp.SDKs: SDK and related client-facing artifacts.