Documentation

Compact a series file offline

This page documents an earlier version of InfluxDB OSS. InfluxDB 3 Core is the latest stable version.

Use the Series File Compaction tool to compact your series file and reduce its size on disk. This is useful for series files that grow quickly, for example, when series are frequently created and deleted.

To compact a series file:

  1. Stop the influxd process.

  2. Run the following command, including your data directory and WAL directory:

    # Syntax
    influx_inspect buildtsi -compact-series-file -datadir <data_dir> -waldir <wal_dir>
    
    # Example
    influx_inspect buildtsi -compact-series-file -datadir /data -waldir /wal
  3. Restart the influxd process.

  4. (InfluxDB Enterprise only) On each data node:

    1. Complete steps 1-3.
    2. Wait for the hinted handoff queue (HHQ) to write all missed data to the node.
    3. Continue to the next data node.

Was this page helpful?

Thank you for your feedback!


New in InfluxDB 3.6

Key enhancements in InfluxDB 3.6 and the InfluxDB 3 Explorer 1.4.

See the Blog Post

InfluxDB 3.6 is now available for both Core and Enterprise. This release introduces the 1.4 update to InfluxDB 3 Explorer, featuring the beta launch of Ask AI, along with new capabilities for simple startup and expanded functionality in the Processing Engine.

For more information, check out:

InfluxDB Docker latest tag changing to InfluxDB 3 Core

On February 3, 2026, the latest tag for InfluxDB Docker images will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments.

If using Docker to install and run InfluxDB, the latest tag will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments. For example, if using Docker to run InfluxDB v2, replace the latest version tag with a specific version tag in your Docker pull command–for example:

docker pull influxdb:2