InfluxDB file system layout
The InfluxDB file system layout depends on the operating system, installation method, or containerization platform used to install InfluxDB.
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
datadirectory, 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
waldirectory, 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
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.
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)
- ~/.influxdbv2/
- engine/
- data/
- TSM directories and files
- wal/
- WAL directories and files
- data/
- configs
- influxd.bolt
- influxd.sqlite
- engine/
Installed as a package
InfluxDB 2.7 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)
- /var/lib/influxdb/
- engine/
- data/
- TSM directories and files
- wal/
- WAL directories and files
- data/
- configs
- influxd.bolt
- influxd.sqlite
- engine/
- /etc/influxdb/
- config.toml (influxd configuration file)
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.
- …/data/
- 000xX00xxXx000x0/ (bucket ID)
- _series/ (series directory)
- 00/ (internal shard index)
- 0000 (internal shard index file)
- 00/ (internal shard index)
- 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)
- index (index directory)
- 0123/ (shard ID)
- _series/ (series directory)
- 000xX00xxXx000x0/ (bucket ID)
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.
- …/wal/
- 000xX00xxXx000x0/ (bucket ID)
- autogen/
- 0123/ (shard ID)
- _01234.wal (WAL file)
- 0123/ (shard ID)
- autogen/
- 000xX00xxXx000x0/ (bucket ID)
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.