OS Manuals

/usr/bin/influxd

Scalable datastore for metrics, events, and real-time analytics (FIPS-enabled)

From influxd-fips-2.8 2.8.0-r9 (enterprise-packages), captured 2026-11-08 by running influxd --help (exit 0). permalink

	Start up the daemon configured with flags/env vars/config file.

	The order of precedence for config options are as follows (1 highest, 3 lowest):
		1. flags
		2. env vars
		3. config file

	A config file can be provided via the INFLUXD_CONFIG_PATH env var. If a file is
	not provided via an env var, influxd will look in the current directory for a
	config.{json|toml|yaml|yml} file. If one does not exist, then it will continue unchanged.

Usage:
  influxd [flags]
  influxd [command]

Available Commands:
  completion   Generate the autocompletion script for the specified shell
  downgrade    Downgrade metadata schema used by influxd to match the expectations of an older release
  help         Help about any command
  inspect      Commands for inspecting on-disk database data
  recovery     Commands used to recover / regenerate operator access to the DB
  run          Start the influxd server
  upgrade      Upgrade a 1.x version of InfluxDB
  version      Print the influxd server version

Flags:
      --assets-path string                                              override default assets by serving from a specific directory (developer mode)
      --bolt-path string                                                path to boltdb database (default "/tmp/.influxdbv2/influxd.bolt")
      --e2e-testing                                                     add /debug/flush endpoint to clear stores; used for end-to-end tests
      --engine-path string                                              path to persistent engine files (default "/tmp/.influxdbv2/engine")
      --feature-flags stringToString                                    feature flag overrides (default [])
      --flux-log-enabled                                                enables detailed logging for flux queries
      --hardening-enabled                                               enable hardening options (disallow private IPs within flux and templates HTTP requests; disable file URLs in templates)
  -h, --help                                                            help for influxd
      --http-bind-address string                                        bind address for the REST HTTP API (default ":8086")
      --http-idle-timeout duration                                      max duration the server should keep established connections alive while waiting for new requests. Set to 0 for no timeout (default 3m0s)
      --http-read-header-timeout duration                               max duration the server should spend trying to read HTTP headers for new requests. Set to 0 for no timeout (default 10s)
      --http-read-timeout duration                                      max duration the server should spend trying to read the entirety of new requests. Set to 0 for no timeout
      --http-write-timeout duration                                     max duration the server should spend on processing+responding to requests. Set to 0 for no timeout
      --influxql-max-select-buckets int                                 The maximum number of group by time bucket a SELECT can create. A value of zero will max the maximum number of buckets unlimited.
      --influxql-max-select-point int                                   The maximum number of points a SELECT can process. A value of 0 will make the maximum point count unlimited. This will only be checked every second so queries will not be aborted immediately when hitting the limit.
      --influxql-max-select-series int                                  The maximum number of series a SELECT can run. A value of 0 will make the maximum series count unlimited.
      --instance-id string                                              add an instance id for replications to prevent collisions and allow querying by edge node
      --log-level Log-Level                                             supported log levels are debug, info, and error (default info)
      --metrics-disabled                                                Don't expose metrics over HTTP at /metrics
      --no-tasks                                                        disables the task scheduler
      --overwrite-pid-file                                              overwrite PID file if it already exists instead of exiting
      --pid-file string                                                 write process ID to a file
      --pprof-disabled                                                  Don't expose debugging information over HTTP at /debug/pprof
      --query-concurrency int32                                         the number of queries that are allowed to execute concurrently. Set to 0 to allow an unlimited number of concurrent queries (default 1024)
      --query-initial-memory-bytes int                                  the initial number of bytes allocated for a query when it is started. If this is unset, then query-memory-bytes will be used
      --query-max-memory-bytes int                                      the maximum amount of memory used for queries. Can only be set when query-concurrency is limited. If this is unset, then this number is query-concurrency * query-memory-bytes
      --query-memory-bytes int                                          maximum number of bytes a query is allowed to use at any given time. This must be greater or equal to query-initial-memory-bytes
      --query-queue-size int32                                          the number of queries that are allowed to be awaiting execution before new queries are rejected. Must be > 0 if query-concurrency is not unlimited (default 1024)
      --reporting-disabled                                              disable sending telemetry data to https://telemetry.influxdata.com every 8 hours
      --secret-store string                                             data store for secrets (bolt or vault) (default "bolt")
      --session-length int                                              ttl in minutes for newly created sessions (default 60)
      --session-renew-disabled                                          disables automatically extending session ttl on request
      --sqlite-path string                                              path to sqlite database. if not set, sqlite database will be stored in the bolt-path directory as "influxd.sqlite".
      --storage-cache-max-memory-size Size                              The maximum size a shard's cache can reach before it starts rejecting writes. (default 1.0 GiB)
      --storage-cache-snapshot-memory-size Size                         The size at which the engine will snapshot the cache and write it to a TSM file, freeing up memory. (default 25 MiB)
      --storage-cache-snapshot-write-cold-duration Duration             The length of time at which the engine will snapshot the cache and write it to a new TSM file if the shard hasn't received writes or deletes. (default 10m0s)
      --storage-compact-full-write-cold-duration Duration               The duration at which the engine will compact all TSM files in a shard if it hasn't received a write or delete. (default 4h0m0s)
      --storage-compact-throughput-burst Size                           The rate limit in bytes per second that we will allow TSM compactions to write to disk. (default 48 MiB)
      --storage-max-concurrent-compactions int                          The maximum number of concurrent full and level compactions that can run at one time.  A value of 0 results in 50% of runtime.GOMAXPROCS(0) used at runtime.  Any number greater than 0 limits compactions to that value.  This setting does not apply to cache snapshotting.
      --storage-max-index-log-file-size Size                            The threshold, in bytes, when an index write-ahead log file will compact into an index file. Lower sizes will cause log files to be compacted more quickly and result in lower heap usage at the expense of write throughput. (default 1.0 MiB)
      --storage-no-validate-field-size                                  Skip field-size validation on incoming writes.
      --storage-retention-check-interval Duration                       The interval of time when retention policy enforcement checks run. (default 30m0s)
      --storage-series-file-max-concurrent-snapshot-compactions int     The maximum number of concurrent snapshot compactions that can be running at one time across all series partitions in a database.
      --storage-series-id-set-cache-size int                            The size of the internal cache used in the TSI index to store previously calculated series results.
      --storage-shard-precreator-advance-period Duration                The default period ahead of the endtime of a shard group that its successor group is created. (default 30m0s)
      --storage-shard-precreator-check-interval Duration                The interval of time when the check to pre-create new shards runs. (default 10m0s)
      --storage-tsm-use-madv-willneed                                   Controls whether we hint to the kernel that we intend to page in mmap'd sections of TSM files.
      --storage-validate-keys                                           Validates incoming writes to ensure keys only have valid unicode characters.
      --storage-wal-flush-on-shutdown                                   Flushes and clears the WAL on shutdown
      --storage-wal-fsync-delay Duration                                The amount of time that a write will wait before fsyncing. A duration greater than 0 can be used to batch up multiple fsync calls. This is useful for slower disks or when WAL write contention is seen. (default 0s)
      --storage-wal-max-concurrent-writes int                           The max number of writes that will attempt to write to the WAL at a time. (default <nprocs> * 2)
      --storage-wal-max-write-delay storage-wal-max-concurrent-writes   The max amount of time a write will wait when the WAL already has storage-wal-max-concurrent-writes active writes. Set to 0 to disable the timeout. (default 10m0s)
      --storage-write-timeout duration                                  The max amount of time the engine will spend completing a write request before cancelling with a timeout. (default 10s)
      --store string                                                    backing store for REST resources (disk or memory) (default "disk")
      --strong-passwords                                                enable password strength enforcement
      --template-file-urls-disabled                                     disable template file URLs
      --testing-always-allow-setup                                      ensures the /api/v2/setup endpoint always returns true to allow onboarding
      --tls-cert string                                                 TLS certificate for HTTPs
      --tls-key string                                                  TLS key for HTTPs
      --tls-min-version string                                          Minimum accepted TLS version (default "1.2")
      --tls-strict-ciphers                                              Restrict accept ciphers to: ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, ECDHE_RSA_WITH_AES_128_GCM_SHA256, ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, ECDHE_RSA_WITH_AES_256_GCM_SHA384, ECDHE_ECDSA_WITH_CHACHA20_POLY1305, ECDHE_RSA_WITH_CHACHA20_POLY1305
      --tracing-type string                                             supported tracing types are log, jaeger
      --ui-disabled                                                     Disable the InfluxDB UI
      --use-hashed-tokens                                               enable storing hashed API tokens on disk (improves security, but prevents downgrades to < 2.8)
      --vault-addr string                                               address of the Vault server expressed as a URL and port, for example: https://127.0.0.1:8200/.
      --vault-cacert string                                             path to a PEM-encoded CA certificate file on the local disk. This file is used to verify the Vault server's SSL certificate. This environment variable takes precedence over VAULT_CAPATH.
      --vault-capath string                                             path to a directory of PEM-encoded CA certificate files on the local disk. These certificates are used to verify the Vault server's SSL certificate.
      --vault-client-cert string                                        path to a PEM-encoded client certificate on the local disk. This file is used for TLS communication with the Vault server.
      --vault-client-key string                                         path to an unencrypted, PEM-encoded private key on disk which corresponds to the matching client certificate.
      --vault-client-timeout duration                                   timeout variable. The default value is 60s.
      --vault-max-retries int                                           maximum number of retries when a 5xx error code is encountered. The default is 2, for three total attempts. Set this to 0 or less to disable retrying.
      --vault-skip-verify                                               do not verify Vault's presented certificate before communicating with it. Setting this variable is not recommended and voids Vault's security model.
      --vault-tls-server-name string                                    name to use as the SNI host when connecting via TLS.
      --vault-token string                                              vault authentication token

Use "influxd [command] --help" for more information about a command.
Options (74)
OptionDescriptionSource
--assets-path stringoverride default assets by serving from a specific directory (developer mode)help
--bolt-path stringpath to boltdb database (default "/tmp/.influxdbv2/influxd.bolt")help
--e2e-testingadd /debug/flush endpoint to clear stores;help
--engine-path stringpath to persistent engine files (default "/tmp/.influxdbv2/engine")help
--feature-flags stringToStringfeature flag overrides (default [])help
--flux-log-enabledenables detailed logging for flux querieshelp
--hardening-enabledenable hardening options (disallow private IPs within flux and templates HTTP requests;help
-h, --helphelp for influxdhelp
--http-bind-address stringbind address for the REST HTTP API (default ":8086")help
--http-idle-timeout durationmax duration the server should keep established connections alive while waiting for new requests.help
--http-read-header-timeout durationmax duration the server should spend trying to read HTTP headers for new requests.help
--http-read-timeout durationmax duration the server should spend trying to read the entirety of new requests.help
--http-write-timeout durationmax duration the server should spend on processing+responding to requests.help
--influxql-max-select-buckets intThe maximum number of group by time bucket a SELECT can create.help
--influxql-max-select-point intThe maximum number of points a SELECT can process.help
--influxql-max-select-series intThe maximum number of series a SELECT can run.help
--instance-id stringadd an instance id for replications to prevent collisions and allow querying by edge nodehelp
--log-level Log-Levelsupported log levels are debug, info, and error (default info)help
--metrics-disabledDon't expose metrics over HTTP at /metricshelp
--no-tasksdisables the task schedulerhelp
--overwrite-pid-fileoverwrite PID file if it already exists instead of exitinghelp
--pid-file stringwrite process ID to a filehelp
--pprof-disabledDon't expose debugging information over HTTP at /debug/pprofhelp
--query-concurrency int32the number of queries that are allowed to execute concurrently.help
--query-initial-memory-bytes intthe initial number of bytes allocated for a query when it is started.help
--query-max-memory-bytes intthe maximum amount of memory used for queries.help
--query-memory-bytes intmaximum number of bytes a query is allowed to use at any given time.help
--query-queue-size int32the number of queries that are allowed to be awaiting execution before new queries are rejected.help
--reporting-disableddisable sending telemetry data to https://telemetry.influxdata.com every 8 hourshelp
--secret-store stringdata store for secrets (bolt or vault) (default "bolt")help
--session-length intttl in minutes for newly created sessions (default 60)help
--session-renew-disableddisables automatically extending session ttl on requesthelp
--sqlite-path stringpath to sqlite database.help
--storage-cache-max-memory-size SizeThe maximum size a shard's cache can reach before it starts rejecting writes.help
--storage-cache-snapshot-memory-size SizeThe size at which the engine will snapshot the cache and write it to a TSM file, freeing up memory.help
--storage-cache-snapshot-write-cold-duration DurationThe length of time at which the engine will snapshot the cache and write it to a new TSM file if the shard hasn't received writes or deletes.help
--storage-compact-full-write-cold-duration DurationThe duration at which the engine will compact all TSM files in a shard if it hasn't received a write or delete.help
--storage-compact-throughput-burst SizeThe rate limit in bytes per second that we will allow TSM compactions to write to disk.help
--storage-max-concurrent-compactions intThe maximum number of concurrent full and level compactions that can run at one time.help
--storage-max-index-log-file-size SizeThe threshold, in bytes, when an index write-ahead log file will compact into an index file.help
--storage-no-validate-field-sizeSkip field-size validation on incoming writes.help
--storage-retention-check-interval DurationThe interval of time when retention policy enforcement checks run.help
--storage-series-file-max-concurrent-snapshot-compactions intThe maximum number of concurrent snapshot compactions that can be running at one time across all series partitions in a database.help
--storage-series-id-set-cache-size intThe size of the internal cache used in the TSI index to store previously calculated series results.help
--storage-shard-precreator-advance-period DurationThe default period ahead of the endtime of a shard group that its successor group is created.help
--storage-shard-precreator-check-interval DurationThe interval of time when the check to pre-create new shards runs.help
--storage-tsm-use-madv-willneedControls whether we hint to the kernel that we intend to page in mmap'd sections of TSM files.help
--storage-validate-keysValidates incoming writes to ensure keys only have valid unicode characters.help
--storage-wal-flush-on-shutdownFlushes and clears the WAL on shutdownhelp
--storage-wal-fsync-delay DurationThe amount of time that a write will wait before fsyncing.help
--storage-wal-max-concurrent-writes intThe max number of writes that will attempt to write to the WAL at a time.help
--storage-wal-max-write-delay storage-wal-max-concurrent-writesThe max amount of time a write will wait when the WAL already has storage-wal-max-concurrent-writes active writes.help
--storage-write-timeout durationThe max amount of time the engine will spend completing a write request before cancelling with a timeout.help
--store stringbacking store for REST resources (disk or memory) (default "disk")help
--strong-passwordsenable password strength enforcementhelp
--template-file-urls-disableddisable template file URLshelp
--testing-always-allow-setupensures the /api/v2/setup endpoint always returns true to allow onboardinghelp
--tls-cert stringTLS certificate for HTTPshelp
--tls-key stringTLS key for HTTPshelp
--tls-min-version stringMinimum accepted TLS version (default "1.2")help
--tls-strict-ciphersRestrict accept ciphers to: ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, ECDHE_RSA_WITH_AES_128_GCM_SHA256, ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, ECDHE_RSA_WITH_AES_256_GCM_SHA384,…help
--tracing-type stringsupported tracing types are log, jaegerhelp
--ui-disabledDisable the InfluxDB UIhelp
--use-hashed-tokensenable storing hashed API tokens on disk (improves security, but prevents downgrades to < 2.8)help
--vault-addr stringaddress of the Vault server expressed as a URL and port, for example: https://127.0.0.1:8200/.help
--vault-cacert stringpath to a PEM-encoded CA certificate file on the local disk.help
--vault-capath stringpath to a directory of PEM-encoded CA certificate files on the local disk.help
--vault-client-cert stringpath to a PEM-encoded client certificate on the local disk.help
--vault-client-key stringpath to an unencrypted, PEM-encoded private key on disk which corresponds to the matching client certificate.help
--vault-client-timeout durationtimeout variable.help
--vault-max-retries intmaximum number of retries when a 5xx error code is encountered.help
--vault-skip-verifydo not verify Vault's presented certificate before communicating with it.help
--vault-tls-server-name stringname to use as the SNI host when connecting via TLS.help
--vault-token stringvault authentication tokenhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.