Quick Start

This document will guide you through methods to get started quickly with IoTDB.

1. How to Install and Deploy?

This guide will assist you in quickly installing and deploying IoTDB. You can quickly navigate to the content you need to review through the following document links:

1. Prepare the necessary machine resources: The deployment and operation of IoTDB require consideration of various aspects of machine resource configuration. For specific resource configurations, please refer to Database Resource

2. Complete system configuration preparations: IoTDB's system configuration involves multiple aspects. For an introduction to key system configurations, please see System Requirements

3. Obtain the installation package: You can obtain the IoTDB installation package on the Apache IoTDB official website.For the specific structure of the installation package, please refer toObtain TimechoDB

4. Install the database and activate it: Depending on your actual deployment architecture, you can choose from the following tutorials for installation and deployment:

   • Stand-Alone Deployment: Stand-Alone Deployment

   • Cluster Deployment:Cluster Deployment

❗️Note: We currently still recommend direct installation and deployment on physical/virtual machines. For Docker deployment, please refer to Docker Deployment

2. How to Use IoTDB?

1. Database Modeling Design: Database modeling is a crucial step in creating a database system, involving the design of data structures and relationships to ensure that the organization of data meets the needs of specific applications. The following documents will help you quickly understand IoTDB's modeling design:

   • Introduction to Time Series Concepts: Navigating Time Series Data

   • Introduction to Modeling Design:Data Model and Terminology

   • Introduction to Database:Database Management

   • Introduction to Tables: Table Management

2. Data Insertion & Updates: IoTDB provides multiple methods for inserting real-time data. For basic data insertion and updating operations, please see Write&Updata Data

3. Data Querying: IoTDB offers a rich set of data querying capabilities. For a basic introduction to data querying, please see Query Data

4. Data Deletion: IoTDB supports two deletion methods: SQL-based deletion and automatic expiration deletion (TTL).

   • SQL-Based Deletion: For a basic introduction, please refer to Delete Data

   • Automatic Expiration Deletion (TTL): For a basic introduction, please see TTL Delete Data

5. Advanced Features: In addition to common database functions such as insertion and querying, IoTDB also supports features like "data synchronization." For specific usage methods, please refer to the respective documents:

   • Data Synchronization: Data Sync

6. Application Programming Interfaces (APIs): IoTDB provides various application programming interfaces (APIs) to facilitate developers' interaction with IoTDB in applications. Currently supported interfaces include Java Native API、Python Native API、JDBC, and more. For more programming interfaces, please refer to the [Application Programming Interfaces] section on the official website.

3. Want to learn more technical details?

If you want to explore IoTDB’s internal mechanisms further, refer to the following documents:

• Data Partitioning and Load Balancing: IoTDB is designed with a partitioning strategy and load balancing algorithm to enhance cluster availability and performance. For more details, please see Cluster data partitioning

• Compression & Encoding: IoTDB employs various encoding and compression techniques optimized for different data types to improve storage efficiency. For more details, please see Encoding and Compression