Self-host Apache IoTDB
v2.0.11Industrial IoT time-series database with edge-cloud sync
- Stars
- 6 425
- Ports
- 10710 (ConfigNode internal port), 10720 (ConfigNode consensus port), 10730 (DataNode internal port), 10740 (DataNode MPP data exchange port), 10750 (DataNode schema region consensus port), 10760 (DataNode data region consensus port)
- Requires
- Java Runtime
apache/iotdbWhat is Apache IoTDB?
Apache IoTDB is a time-series database management system designed for industrial IoT scenarios. It provides high-throughput data ingestion and low-latency queries for millions of devices, with a lightweight architecture supporting edge-cloud collaboration. Key capabilities include a flexible deployment model (standalone, cluster, or edge), a high compression ratio reducing storage costs, SQL-like query language with JDBC support, time alignment and aggregation functions across devices, and native integration with the Hadoop, Spark, and Flink ecosystems plus Grafana visualization. It runs on Linux, Windows, and macOS with Java 17+, and can be deployed via binary packages, Docker, or built from source. The project is a top-level Apache project with active development and a growing community.
Should you self-host Apache IoTDB?
Apache IoTDB scores 68/100 on selfhost.directory (how scoring works) and ranks #16 of 38 in Databases. It has 6 425 GitHub stars.
It shipped 7 stable releases in the past year. The latest, v2.0.11, came out on 13 September 2026. New versions land roughly every 5 weeks.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Java.
Its closest alternative on selfhost.directory is Redis (86/100, 77 142 stars). It scores higher overall, so compare the two before you pick. See Apache IoTDB vs Redis side by side.
Features
- Built-in Authentication
- Cluster mode with ConfigNode/DataNode
- CSV import/export tools
- Edge-cloud synchronization
- Flexible Deployment Modes
- Grafana visualization
- Hadoop/Spark/Flink integration
- High compression ratio
- High-throughput read/write
- JDBC standard API
- Multi-Platform Support
- SQL-like query language
- Time alignment and aggregation
- Time-series data storage
Apache IoTDB README
FAQ
How to resolve lsof issues in IoTDB deployment?
Install the correct lsof RPM package for your OS version, verify with 'lsof -v', create a symlink to /bin/lsof if needed, and ensure the version is compatible.
How to deal with estimated out of memory errors?
Increase heap memory above 4.2GB, adjust datanode_memory_proportion and chunk_timeseriesmeta_free_memory_proportion parameters, reduce exported time series, add slimit to queries, or use 'align by device'.
How can I change IoTDB's CLI time display format?
Add the -disableISO8601 parameter to the start-cli command to display timestamps instead of ISO8601 format.
How does IoTDB handle duplicate points?
A data point is uniquely identified by its full time series path and timestamp. Submitting a new point with the same path and timestamp updates the existing value instead of inserting a duplicate.
Can I use Hadoop and Spark to read TsFile in IoTDB?
Yes, IoTDB has connectors for Hadoop, Spark, and Grafana visualization.
How do I know how many time series are stored in IoTDB?
Use 'show timeseries root' or 'count timeseries root' in the CLI, or grep the schema mlog.txt file on Linux.
Where can I find IoTDB data files?
By default, data files (including tsfile, metadata, and WAL files) are stored under IOTDB_HOME/data/datanode.
Where can I find IoTDB logs?
By default, logs are stored under IOTDB_HOME/logs. You can change the log level and storage path by configuring logback.xml under IOTDB_HOME/conf.
How can I identify my version of IoTDB?
Launch the CLI with start-cli.sh, check pom.xml, use JDBC API getDatabaseProductVersion(), or run 'show version' in the CLI.
More in Data Management
barmanSelf-hosted, open-source disaster-recovery tool for PostgreSQL: remote backups, WAL archiving, point-in-time recovery, incremental, encrypted and cloud backups.
CKANSelf-hosted, open-source data management system for open-data portals and catalogs: publish, share and search datasets via a web UI and a full API.
CouchDBSeamless multi-primary syncing database with an intuitive HTTP/JSON API, designed for reliability
crawlee-cloudCrawlee Cloud is a self-hosted, open-source platform for running Apify Actors on your own infrastructure with a web dashboard, CLI, and full Apify SDK compatibility.
cubeOpen-source semantic layer defining metrics in code. Provides SQL/REST/GraphQL APIs for BI tools and AI agents. Self-host via Docker.
DatabunkerSecure Vault for Customer PII/PHI/PCI/KYC Records
datahubSelf-hosted open-source GIS for harmonizing and exploring spatiotemporal data across health, demographic, and environmental domains with interactive dashboard and API.
DatasetteSelf-hosted, open-source tool that turns SQLite databases into an explorable website and JSON API, with facets, full-text search, SQL queries and plugins.
DataverseDataverse is a self-hosted, open-source research data repository with DOI support, versioning, and rich metadata for sharing and preserving datasets.
diskoverDiskover Community Edition is a self-hosted, open-source file indexer using Elasticsearch to catalog metadata, enabling search, analytics, and cost optimization.
DreamFactoryDreamFactory is a self-hosted, open-source platform that instantly generates secure REST APIs from any database with RBAC, SSO, and MCP server for AI integration.
elasticsearchOpen-source distributed search engine that handles structured, unstructured, and vector data for real-time search, observability, and AI workloads.
0 comments