InfluxDB file system layout

The InfluxDB file structure includes of the following:

Engine path

Directory path to the storage engine, where InfluxDB stores time series data, includes the following directories:

  • data: stores Time-Structured Merge Tree (TSM) files
  • wal: stores Write Ahead Log (WAL) files.

To customize this path, use the configuration option.

Bolt path

Configs path

File path to influx CLI connection configurations (configs). To customize this path, use the flag with influx CLI commands.

InfluxDB configuration files

Some operating systems and package managers store a default InfluxDB (influxd) configuration file on disk. For more information about using InfluxDB configuration files, see Configuration options.

File system layout

macOS Windows Kubernetes

macOS default paths

macOS file system overview

  • ~/.influxdbv2/
    • engine/
      • data/
        • TSM directories and files
    • configs
    • influxd.bolt
    • influxd.sqlite

Linux default paths (standalone binary)

PathDefault
Engine path~/.influxdbv2/engine/
~/.influxdbv2/influxd.bolt
SQLite path~/.influxdbv2/influxd.sqlite

Linux file system overview (standalone binary)

  • ~/.influxdbv2/
    • engine/
      • data/
        • TSM directories and files
      • wal/
        • WAL directories and files
    • configs
    • influxd.bolt
    • influxd.sqlite

InfluxDB 2.2 supports .deb- and .rpm-based Linux package managers. The file system layout is the same with each.

Linux default paths (package)

Linux file system overview (package)

  • /var/lib/influxdb/
    • engine/
      • data/
        • TSM directories and files
      • wal/
        • WAL directories and files
    • configs
    • influxd.bolt
    • influxd.sqlite
  • /etc/influxdb/
    • config.toml (influxd configuration file)

Windows default paths

PathDefault
Engine path%USERPROFILE%.influxdbv2\engine\
%USERPROFILE%.influxdbv2\influxd.bolt
SQLite path%USERPROFILE%.influxdbv2\influxd.sqlite
%USERPROFILE%.influxdbv2\configs

Windows file system overview

  • %USERPROFILE%\.influxdbv2\
    • engine\
      • data\
        • TSM directories and files
      • wal\
        • WAL directories and files
    • influxd.bolt
    • influxd.sqlite

InfluxDB Docker images are available from both and Quay.io. Each have a unique InfluxDB file system layout.

The InfluxDB Dockerhub image uses /var/lib/influxdb2 instead of so you can easily mount separate volumes for InfluxDB 1.x and 2.x data during the .

Dockerhub default paths

Dockerhub file system overview

  • /var/lib/influxdb2/
    • engine/
      • data/
        • TSM directories and files
      • wal/
        • WAL directories and files
    • influxd.bolt
    • influxd.sqlite
  • /etc/influxdb2/
    • configs

Quay default paths

PathDefault
/root/.influxdbv2/engine/
Bolt path/root/.influxdbv2/influxd.bolt
/root/.influxdbv2/influxd.sqlite
Configs path/root/.influxdbv2/configs

Quay file system overview

  • /root/.influxdbv2/
    • engine/
      • data/
        • TSM directories and files
      • wal/
        • WAL directories and files
    • configs
    • influxd.bolt
    • influxd.sqlite

Kubernetes default paths

Kubernetes file system overview

  • /var/lib/influxdb2/
    • engine/
      • data/
        • TSM directories and files
      • wal/
        • WAL directories and files
    • influxd.bolt
    • influxd.sqlite
  • /etc/influxdb2/