How jeanloickdt/instantiot-server works
InstantIoT is a self-hosted IoT relay and web-admin server. Its primary workflow is a board connecting over TCP and sending signal values, which the server relays to app WebSockets and stores as time-series history; authenticated users manage projects, devices, and signals through the admin/API, while automation can react to relay events. The README documents discovery, backups, and multi-tier history. The graph uses those documented relationships plus the shown source references; some runtime wiring and unsampled implementation details are intentionally omitted.
Main entry points: Application.kt Ktor server · AutomationEngine.kt Automation engine · DeviceRelay.kt Device TCP relay · SignalIngest.kt Signal ingest
Components 24
Server and access
- Ktor server
src/main/kotlin/com/jeanloickdt/Application.kt - Accounts and JWT
src/main/kotlin/com/jeanloickdt/auth/AuthRoutes.kt - User storage
src/main/kotlin/com/jeanloickdt/auth/data/SqliteUserRepository.kt
Projects and signals
- Projects
src/main/kotlin/com/jeanloickdt/project/ProjectRoutes.kt - Project storage
src/main/kotlin/com/jeanloickdt/project/data/ExposedProjectRepository.kt - Device management
src/main/kotlin/com/jeanloickdt/device/DeviceRoutes.kt - Device storage
src/main/kotlin/com/jeanloickdt/device/data/ExposedDeviceRepository.kt - Signal API
src/main/kotlin/com/jeanloickdt/signal/SignalRoutes.kt - Signal history
src/main/kotlin/com/jeanloickdt/signal/data/ExposedSignalHistoryRepository.kt
Live relay
- Device TCP relay
src/main/kotlin/com/jeanloickdt/relay/DeviceRelay.kt - Signal ingest
src/main/kotlin/com/jeanloickdt/signal/SignalIngest.kt - Connection registry
src/main/kotlin/com/jeanloickdt/relay/ConnectionRegistry.kt - App WebSocket relay
src/main/kotlin/com/jeanloickdt/relay/AppRelay.kt - Relay event sinks
src/main/kotlin/com/jeanloickdt/event/EventSinks.kt
Rules and actions
- Rule management
src/main/kotlin/com/jeanloickdt/automation/RuleRoutes.kt - Automation engine
src/main/kotlin/com/jeanloickdt/automation/v2/AutomationEngine.kt - Automation runs
src/main/kotlin/com/jeanloickdt/automation/v2/AutomationRuns.kt - Action delivery
src/main/kotlin/com/jeanloickdt/automation/DeliveryWorker.kt
Operations
- LAN discovery
src/main/kotlin/com/jeanloickdt/discovery/MdnsPublisher.kt - Database backups
src/main/kotlin/com/jeanloickdt/backup/BackupManager.kt - SQLite database
src/main/kotlin/com/jeanloickdt/database/DatabaseFactory.kt
Other components
- Admin user
- IoT board
- InstantIoT app
Connections 26
- Admin user → Ktor server: uses admin panel
README.md - InstantIoT app → Ktor server: uses server
README.md - IoT board → Device TCP relay: sends TCP frames
README.md - Ktor server → Accounts and JWT: configures
src/main/kotlin/com/jeanloickdt/Application.kt - Accounts and JWT → User storage: reads and writes
- Ktor server → Projects: registers routes
src/main/kotlin/com/jeanloickdt/Application.kt - Projects → Project storage: accesses projects
src/main/kotlin/com/jeanloickdt/project/ProjectRoutes.kt - Ktor server → Device management: registers routes
src/main/kotlin/com/jeanloickdt/Application.kt - Device management → Device storage: accesses devices
src/main/kotlin/com/jeanloickdt/device/DeviceRoutes.kt - Ktor server → Signal API: registers routes
src/main/kotlin/com/jeanloickdt/Application.kt - Signal API → Signal history: queries history
src/main/kotlin/com/jeanloickdt/signal/SignalRoutes.kt - Device TCP relay → Signal ingest: dispatches values
- Signal ingest → Signal history: stores samples
- Device TCP relay → Connection registry: registers sessions
- App WebSocket relay → Connection registry: uses sessions
- App WebSocket relay → InstantIoT app: relays live values
README.md - Signal ingest → Relay event sinks: publishes events
src/main/kotlin/com/jeanloickdt/signal/SignalIngest.kt - Relay event sinks → Automation engine: provides events
src/main/kotlin/com/jeanloickdt/automation/v2/AutomationEngine.kt - Ktor server → Rule management: registers routes
- Rule management → Automation engine: configures rules
src/main/kotlin/com/jeanloickdt/automation/RuleRoutes.kt - Automation engine → Automation runs: records runs
src/main/kotlin/com/jeanloickdt/automation/v2/AutomationEngine.kt - Automation engine → Action delivery: dispatches actions
src/main/kotlin/com/jeanloickdt/automation/v2/AutomationEngine.kt - Ktor server → LAN discovery: starts discovery
src/main/kotlin/com/jeanloickdt/Application.kt - Ktor server → Database backups: starts backup service
src/main/kotlin/com/jeanloickdt/Application.kt - Database backups → SQLite database: snapshots database
src/main/kotlin/com/jeanloickdt/backup/BackupManager.kt - Ktor server → SQLite database: initializes storage
src/main/kotlin/com/jeanloickdt/Application.kt