docs-v2/content/influxdb/v2/reference/internals/file-system-layout.md

title	description	weight	menu	influxdb/v2/tags	related
InfluxDB file system layout	The InfluxDB file system layout depends on the operating system, package manager, or containerization platform used to install InfluxDB.	102	influxdb_v2 name parent File system layout InfluxDB internals	storage internals	/influxdb/v2/admin/internals/

The InfluxDB file system layout depends on the operating system, installation method, or containerization platform used to install InfluxDB.

• InfluxDB file structure
  • Engine path
  • Bolt path
  • SQLite path
  • Configs path
  • InfluxDB configuration files
• File system layout
  • Installed as a standalone binary
  • Installed as a package
  • Docker Hub
  • Quay.io

InfluxDB file structure

The InfluxDB file structure includes 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. For more information about the structure of the data directory, see TSM directories and files layout.
• replicationq: Store the replication queue for the InfluxDB replication service.
• wal: Stores write-ahead log (WAL) files. For more information about the structure of the wal directory, see WAL directories and files layout.

To customize this path, use the engine-path configuration option.

Bolt path

File path to the Boltdb database, a file-based key-value store for non-time series data, such as InfluxDB users, dashboards, and tasks. To customize this path, use the bolt-path configuration option.

SQLite path

File path to the SQLite database, an SQL database for non-time series data, such as InfluxDB notebooks and annotations. To customize this path, use the sqlite-path configuration option.

Configs path

File path to influx CLI connection configurations (configs).

To use a custom path, pass the --configs-path 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

{{< tabs-wrapper >}} {{% tabs %}} macOS Linux Windows Docker Kubernetes {{% /tabs %}}

{{% tab-content %}}

macOS default paths

Path	Default
Engine path	~/.influxdbv2/engine/
Bolt path	~/.influxdbv2/influxd.bolt
SQLite path	~/.influxdbv2/influxd.sqlite
Configs path	~/.influxdbv2/configs

macOS file system overview

{{% filesystem-diagram %}}

• ~/.influxdbv2/
  • engine/
    • data/
      • TSM directories and files
    • wal/
      • WAL directories and files
  • configs
  • influxd.bolt
  • influxd.sqlite {{% /filesystem-diagram %}} {{% /tab-content %}}

{{% tab-content %}} When installing InfluxDB on Linux, you can download and install the influxd binary, or you can use a package manager. Which installation method you use determines the file system layout.

• InfluxDB file structure
• File system layout
  • Installed as a standalone binary
  • Installed as a package
  • Docker Hub
  • Quay.io

Installed as a standalone binary

Linux default paths (standalone binary)

Path	Default
Engine path	~/.influxdbv2/engine/
Bolt path	~/.influxdbv2/influxd.bolt
SQLite path	~/.influxdbv2/influxd.sqlite
Configs path	~/.influxdbv2/configs

Linux file system overview (standalone binary)

{{% filesystem-diagram %}}

• ~/.influxdbv2/
  • engine/
    • data/
      • TSM directories and files
    • wal/
      • WAL directories and files
  • configs
  • influxd.bolt
  • influxd.sqlite {{% /filesystem-diagram %}}

Installed as a package

InfluxDB {{< current-version >}} supports .deb- and .rpm-based Linux package managers. The file system layout is the same with each.

Linux default paths (package)

Path	Default
Engine path	/var/lib/influxdb/engine/
Bolt path	/var/lib/influxdb/influxd.bolt
SQLite path	/var/lib/influxdb/influxd.sqlite
Configs path	/var/lib/influxdb/configs
Default config file path	/etc/influxdb/config.toml

Linux file system overview (package)

{{% filesystem-diagram %}}

• /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) {{% /filesystem-diagram %}} {{% /tab-content %}}

{{% tab-content %}}

Windows default paths

Path	Default
Engine path	%USERPROFILE%\.influxdbv2\engine\
Bolt path	%USERPROFILE%\.influxdbv2\influxd.bolt
SQLite path	%USERPROFILE%\.influxdbv2\influxd.sqlite
Configs path	%USERPROFILE%\.influxdbv2\configs

Windows file system overview

{{% filesystem-diagram %}}

• %USERPROFILE%\.influxdbv2\
  • engine\
    • data\
      • TSM directories and files
    • wal\
      • WAL directories and files
  • configs
  • influxd.bolt
  • influxd.sqlite {{% /filesystem-diagram %}} {{% /tab-content %}}

{{% tab-content %}} InfluxDB Docker images are available from both Docker Hub and Quay.io. Each has a unique InfluxDB file system layout.

• Docker Hub
• Quay.io

Docker Hub

{{% note %}} For InfluxDB v2, the InfluxDB Docker Hub image uses /var/lib/influxdb2 instead of /var/lib/influxdb so you can easily mount separate volumes for InfluxDB 1.x and 2.x data during the upgrade process. {{% /note %}}

Docker Hub default paths

Path	Default
Engine path	/var/lib/influxdb2/engine/
Bolt path	/var/lib/influxdb2/influxd.bolt
SQLite path	/var/lib/influxdb2/influxd.sqlite
Configs path	/etc/influxdb2/influx-configs if InfluxDB is set up using automated setup mode or influx setup from within the container; /etc/influxdb2/configs otherwise.

Docker Hub file system overview

{{% filesystem-diagram %}}

• /var/lib/influxdb2/
  • engine/
    • data/
      • TSM directories and files
    • wal/
      • WAL directories and files
  • influxd.bolt
  • influxd.sqlite
• /etc/influxdb2/
  • configs
  • influx-configs {{% /filesystem-diagram %}}

Quay.io

Quay default paths

Path	Default
Engine path	/root/.influxdbv2/engine/
Bolt path	/root/.influxdbv2/influxd.bolt
SQLite path	/root/.influxdbv2/influxd.sqlite
Configs path	/root/.influxdbv2/configs

Quay file system overview

{{% filesystem-diagram %}}

• /root/.influxdbv2/
  • engine/
    • data/
      • TSM directories and files
    • wal/
      • WAL directories and files
  • configs
  • influxd.bolt
  • influxd.sqlite {{% /filesystem-diagram %}} {{% /tab-content %}}

{{% tab-content %}}

Kubernetes default paths

Path	Default
Engine path	/var/lib/influxdb2/engine/
Bolt path	/var/lib/influxdb2/influxd.bolt
SQLite path	/var/lib/influxdb2/influxd.sqlite
Configs path	/etc/influxdb2/configs

Kubernetes file system overview

{{% filesystem-diagram %}}

• /var/lib/influxdb2/
  • engine/
    • data/
      • TSM directories and files +
    • wal/
      • WAL directories and files
  • influxd.bolt
  • influxd.sqlite
• /etc/influxdb2/
  • configs {{% /filesystem-diagram %}} {{% /tab-content %}}

{{< /tabs-wrapper >}}

---

TSM directories and files layout

TSM directories and files are stored in the data directory inside the engine path. The diagram below is relative to the engine path.

{{% filesystem-diagram %}}

• .../data/
  • 000xX00xxXx000x0/ (bucket ID)
    • _series/ (series directory)
      • 00/ (internal shard index)
        • 0000 (internal shard index file)
    • autogen
      • 0123/ (shard ID)
        • index (index directory)
          • L0-00000001.tsl (write-ahead log for the TSI index)
          • L0-00000001.tsi (series index)
          • MANIFEST (index manifest) {{% /filesystem-diagram %}}

WAL directories and files layout

WAL directories and files are stored in the data directory inside the engine path. The diagram below is relative to the engine path.

{{% filesystem-diagram %}}

• .../wal/
  • 000xX00xxXx000x0/ (bucket ID)
    • autogen/
      • 0123/ (shard ID)
        • _01234.wal (WAL file) {{% /filesystem-diagram %}}