InfluxDB configuration options

Customize your InfluxDB configuration by using influxd configuration flags, setting environment variables, or defining configuration options in a configuration file.

Configuration precedence

InfluxDB honors configuration settings using the following precedence:

1. influxd flags
2. Environment variables
3. Configuration file settings

InfluxDB configuration file

When influxd starts, it checks for a file named config.* in the current working directory. The file extension depends on the syntax of the configuration file. InfluxDB configuration files support the following syntaxes:

• YAML (.yaml, .yml)
• TOML (.toml)
• JSON (.json)

To customize the directory path of the configuration file, set the INFLUXD_CONFIG_PATH environment variable to your custom path.

export INFLUXD_CONFIG_PATH=/path/to/custom/config/directory

On startup, influxd will check for a config.* in the INFLUXD_CONFIG_PATH directory.

Example configuration file

YAML TOML JSON

query-concurrency: 20
query-queue-size: 15
secret-store: vault
session-length: 120
tls-cert: /path/to/influxdb.crt
tls-key: /path/to/influxdb.key

query-concurrency = 20
query-queue-size = 15
secret-store = "vault"
session-length = 120
tls-cert = "/path/to/influxdb.crt"
tls-key = "/path/to/influxdb.key"

{
  "query-concurrency": 20,
  "query-queue-size": 15,
  "secret-store": "vault",
  "session-length": 120,
  "tls-cert": "/path/to/influxdb.crt",
  "tls-key": "/path/to/influxdb.key"
}

Only non-default settings need to be defined in the configuration file.

Configuration options

To configure InfluxDB, use the following configuration options when starting the influxd service:

• assets-path
• bolt-path
• e2e-testing
• engine-path
• http-bind-address
• influxql-max-select-buckets
• influxql-max-select-point
• influxql-max-select-series
• log-level
• new-meta-store
• new-meta-store-read-only
• no-tasks
• query-concurrency
• query-initial-memory-bytes
• query-max-memory-bytes
• query-memory-bytes
• query-queue-size
• reporting-disabled
• secret-store
• session-length
• session-renew-disabled
• storage-cache-max-memory-size
• storage-cache-snapshot-memory-size
• storage-cache-snapshot-write-cold-duration
• storage-compact-full-write-cold-duration
• storage-compact-throughput-burst
• storage-max-concurrent-compactions
• storage-max-index-log-file-size
• storage-retention-check-interval
• storage-series-file-max-concurrent-snapshot-compactions
• storage-series-id-set-cache-size
• storage-shard-precreator-advance-period
• storage-shard-precreator-check-interval
• storage-tsm-use-madv-willneed
• storage-validate-keys
• storage-wal-fsync-delay
• store
• tls-cert
• tls-key
• tls-min-version
• tls-strict-ciphers
• tracing-type
• vault-addr
• vault-cacert
• vault-capath
• vault-client-cert
• vault-client-key
• vault-max-retries
• vault-client-timeout
• vault-skip-verify
• vault-tls-server-name
• vault-token

assets-path

Override the default InfluxDB user interface (UI) assets by serving assets from the specified directory. Typically, InfluxData internal use only.

influxd flag

influxd --assets-path=/path/to/custom/assets-dir

Environment variable

export INFLUXD_ASSETS_PATH=/path/to/custom/assets-dir

Configuration file

YAML TOML JSON

assets-path: /path/to/custom/assets-dir

assets-path = "/path/to/custom/assets-dir"

{
  "assets-path": "/path/to/custom/assets-dir"
}

bolt-path

Path to the BoltDB database. BoltDB is a key value store written in Go. InfluxDB uses BoltDB to store data including organization and user information, UI data, REST resources, and other key value data.

Default: ~/.influxdbv2/influxd.bolt

influxd flag

influxd --bolt-path=~/.influxdbv2/influxd.bolt

Environment variable

export INFLUXD_BOLT_PATH=~/.influxdbv2/influxd.bolt

Configuration file

YAML TOML JSON

bolt-path: /users/user/.influxdbv2/influxd.bolt

bolt-path = "/users/user/.influxdbv2/influxd.bolt"

{
  "bolt-path": "/users/user/.influxdbv2/influxd.bolt"
}

e2e-testing

Add a /debug/flush endpoint to the InfluxDB HTTP API to clear stores. InfluxData uses this endpoint in end-to-end testing.

influxd flag

influxd --e2e-testing

Environment variable

export INFLUXD_E2E_TESTING=true

Configuration file

YAML TOML JSON

e2e-testing: true

e2e-testing = true

{
  "e2e-testing": true
}

engine-path

Path to persistent storage engine files where InfluxDB stores all Time-Structure Merge Tree (TSM) data on disk.

Default: ~/.influxdbv2/engine

influxd flag

influxd --engine-path=~/.influxdbv2/engine

Environment variable

export INFLUXD_ENGINE_PATH=~/.influxdbv2/engine

Configuration file

YAML TOML JSON

engine-path: /users/user/.influxdbv2/engine

engine-path = "/users/user/.influxdbv2/engine"

{
  "engine-path": "/users/user/.influxdbv2/engine"
}

http-bind-address

Bind address for the InfluxDB HTTP API. Customize the URL and port for the InfluxDB API and UI.

Default: :8086

influxd flag

influxd --http-bind-address=:8086

Environment variable

export INFLUXD_HTTP_BIND_ADDRESS=:8086

Configuration file

YAML TOML JSON

http-bind-address: ":8086"

http-bind-address = ":8086"

{
  "http-bind-address": ":8086"
}

influxql-max-select-buckets

Maximum number of group by time buckets a SELECT statement can create. 0 allows an unlimited number of buckets.

Default: 0

influxd flag

influxd --influxql-max-select-buckets=0

Environment variable

export INFLUXD_INFLUXQL_MAX_SELECT_BUCKETS=0

Configuration file

YAML TOML JSON

influxql-max-select-buckets: 0

influxql-max-select-buckets = 0

{
  "influxql-max-select-buckets": 0
}

influxql-max-select-point

Maximum number of points a SELECT statement can process. 0 allows an unlimited number of points. This is only checked every second so queries will not be aborted immediately when hitting the limit.

Default: 0

influxd flag

influxd --influxql-max-select-point=0

Environment variable

export INFLUXD_INFLUXQL_MAX_SELECT_POINT=0

Configuration file

YAML TOML JSON

influxql-max-select-point: 0

influxql-max-select-point = 0

{
  "influxql-max-select-point": 0
}

influxql-max-select-series

Maximum number of series a SELECT statement can return. 0 allows an unlimited number of series.

Default: 0

influxd flag

influxd --influxql-max-select-series=0

Environment variable

export INFLUXD_INFLUXQL_MAX_SELECT_SERIES=0

Configuration file

YAML TOML JSON

influxql-max-select-series: 0

influxql-max-select-series = 0

{
  "influxql-max-select-series": 0
}

log-level

Log output level. InfluxDB outputs log entries with severity levels greater than or equal to the level specified.

Options: debug, info, error
Default: info

influxd flag

influxd --log-level=info

Environment variable

export INFLUXD_LOG_LEVEL=info

Configuration file

YAML TOML JSON

log-level: info

log-level = "info"

{
  "log-level": "info"
}

new-meta-store

Enable the new meta store.

Default: false

influxd flag

influxd --new-meta-store

Environment variable

export INFLUXD_NEW_META_STORE=true

Configuration file

YAML TOML JSON

new-meta-store: true

new-meta-store = true

{
  "new-meta-store": true
}

new-meta-store-read-only

Toggle read-only mode for the new meta store. If true, reads are duplicated between old and new meta stores (if new meta store is enabled).

Default: true

influxd flag

influxd --new-meta-store-read-only

Environment variable

export INFLUXD_NEW_META_STORE_READ_ONLY=true

Configuration file

YAML TOML JSON

new-meta-store-read-only: true

new-meta-store-read-only = true

{
  "new-meta-store-read-only": true
}

no-tasks

Disable the task scheduler. If problematic tasks prevent InfluxDB from starting, use this option to start InfluxDB without scheduling or executing tasks.

Default: false

influxd flag

influxd --no-tasks

Environment variable

export INFLUXD_NO_TASKS=true

Configuration file

YAML TOML JSON

no-tasks: true

no-tasks = true

{
  "no-tasks": true
}

query-concurrency

Number of queries allowed to execute concurrently.

Default: 10

influxd flag

influxd --query-concurrency=10

Environment variable

export INFLUXD_QUERY_CONCURRENCY=10

Configuration file

YAML TOML JSON

query-concurrency: 10

query-concurrency = 10

{
  "query-concurrency": 10
}

query-initial-memory-bytes

Initial bytes of memory allocated for a query.

Default: equal to query-memory-bytes

influxd flag

influxd --query-initial-memory-bytes=10485760

Environment variable

export INFLUXD_QUERY_INITIAL_MEMORY_BYTES=10485760

Configuration file

YAML TOML JSON

query-initial-memory-bytes: 10485760

query-initial-memory-bytes = 10485760

{
  "query-initial-memory-bytes": 10485760
}

query-max-memory-bytes

Maximum total bytes of memory allowed for queries.

Default: equal to query-concurrency × query-memory-bytes

influxd flag

influxd --query-max-memory-bytes=104857600

Environment variable

export INFLUXD_QUERY_MAX_MEMORY_BYTES=104857600

Configuration file

YAML TOML JSON

query-max-memory-bytes: 104857600

query-max-memory-bytes = 104857600

{
  "query-max-memory-bytes": 104857600
}

query-memory-bytes

Maximum bytes of memory allowed for a single query.

Default: unlimited

Must be greater than or equal to query-initial-memory-bytes.

influxd flag

influxd --query-memory-bytes=10485760

Environment variable

export INFLUXD_QUERY_MEMORY_BYTES=10485760

Configuration file

YAML TOML JSON

query-memory-bytes: 10485760

query-memory-bytes = 10485760

{
  "query-memory-bytes": 10485760
}

query-queue-size

Maximum number of queries allowed in execution queue. When queue limit is reached, new queries are rejected.

Default: 10

influxd flag

influxd --query-queue-size=10

Environment variable

export INFLUXD_QUERY_QUEUE_SIZE=10

Configuration file

YAML TOML JSON

query-queue-size: 10

query-queue-size = 10

{
  "query-queue-size": 10
}

reporting-disabled

Disables sending telemetry data to InfluxData. The InfluxData telemetry page provides information about what data is collected and how InfluxData uses it.

Default: false

influxd flag

influxd --reporting-disabled

Environment variable

export INFLUXD_REPORTING_DISABLED=true

Configuration file

YAML TOML JSON

reporting-disabled: true

reporting-disabled = true

{
  "reporting-disabled": true
}

secret-store

Specifies the data store for secrets such as passwords and tokens. Store secrets in either the InfluxDB internal BoltDB or in Vault.

Options: bolt, vault
Default: bolt

influxd flag

influxd --secret-store=bolt

Environment variable

export INFLUXD_SECRET_STORE=bolt

Configuration file

YAML TOML JSON

secret-store: bolt

secret-store = "bolt"

{
  "secret-store": "bolt"
}

session-length

Specifies the Time to Live (TTL) in minutes for newly created user sessions.

Default: 60

influxd flag

influxd --session-length=60

Environment variable

export INFLUXD_SESSION_LENGTH=60

Configuration file

YAML TOML JSON

session-length: 60

session-length = 60

{
  "session-length": 60
}

session-renew-disabled

Disables automatically extending a user’s session TTL on each request. By default, every request sets the session’s expiration time to five minutes from now. When disabled, sessions expire after the specified session length and the user is redirected to the login page, even if recently active.

Default: false

influxd flag

influxd --session-renew-disabled

Environment variable

export INFLUXD_SESSION_RENEW_DISABLED=true

Configuration file

YAML TOML JSON

session-renew-disabled: true

session-renew-disabled = true

{
  "session-renew-disabled": true
}

storage-cache-max-memory-size

Maximum size (in bytes) a shard’s cache can reach before it starts rejecting writes.

Default: 1073741824

influxd flag

influxd --storage-cache-max-memory-size=1073741824

Environment variable

export INFLUXD_STORAGE_CACHE_MAX_MEMORY_SIZE=1073741824

Configuration file

YAML TOML JSON

storage-cache-max-memory-size: 1073741824

storage-cache-max-memory-size = 1073741824

{
  "storage-cache-max-memory-size": 1073741824
}

storage-cache-snapshot-memory-size

Size (in bytes) at which the storage engine will snapshot the cache and write it to a TSM file to make more memory available.

Default: 26214400)

influxd flag

influxd --storage-cache-snapshot-memory-size=26214400

Environment variable

export INFLUXD_STORAGE_CACHE_SNAPSHOT_MEMORY_SIZE=26214400

Configuration file

YAML TOML JSON

storage-cache-snapshot-memory-size: 26214400

storage-cache-snapshot-memory-size = 26214400

{
  "storage-cache-snapshot-memory-size": 26214400
}

storage-cache-snapshot-write-cold-duration

Duration at which the storage engine will snapshot the cache and write it to a new TSM file if the shard hasn’t received writes or deletes.

Default: 10m0s

influxd flag

influxd --storage-cache-snapshot-write-cold-duration=10m0s

Environment variable

export INFLUXD_STORAGE_CACHE_SNAPSHOT_WRITE_COLD_DURATION=10m0s

Configuration file

YAML TOML JSON

storage-cache-snapshot-write-cold-duration: 10m0s

storage-cache-snapshot-write-cold-duration = "10m0s"

{
  "storage-cache-snapshot-write-cold-duration": "10m0s"
}

storage-compact-full-write-cold-duration

Duration at which the storage engine will compact all TSM files in a shard if it hasn’t received writes or deletes.

Default: 4h0m0s

influxd flag

influxd --storage-compact-full-write-cold-duration=4h0m0s

Environment variable

export INFLUXD_STORAGE_COMPACT_FULL_WRITE_COLD_DURATION=4h0m0s

Configuration file

YAML TOML JSON

storage-compact-full-write-cold-duration: 4h0m0s

storage-compact-full-write-cold-duration = "4h0m0s"

{
  "storage-compact-full-write-cold-duration": "4h0m0s"
}

storage-compact-throughput-burst

Rate limit (in bytes per second) that TSM compactions can write to disk.

Default: 50331648

influxd flag

influxd --storage-compact-throughput-burst=50331648

Environment variable

export INFLUXD_STORAGE_COMPACT_THROUGHPUT_BURST=50331648

Configuration file

YAML TOML JSON

storage-compact-throughput-burst: 50331648

storage-compact-throughput-burst = 50331648

{
  "storage-compact-throughput-burst": 50331648
}

storage-max-concurrent-compactions

Maximum number of full and level compactions that can run concurrently. A value of 0 results in 50% of runtime.GOMAXPROCS(0) used at runtime. Any number greater than zero limits compactions to that value. This setting does not apply to cache snapshotting.

Default: 0

influxd flag

influxd --storage-max-concurrent-compactions=0

Environment variable

export INFLUXD_STORAGE_MAX_CONCURRENT_COMPACTIONS=0

Configuration file

YAML TOML JSON

storage-max-concurrent-compactions: 0

storage-max-concurrent-compactions = 0

{
  "storage-max-concurrent-compactions": 0
}

storage-max-index-log-file-size

Size (in bytes) at which an index write-ahead log (WAL) 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: 1048576

influxd flag

influxd --storage-max-index-log-file-size=1048576

Environment variable

export INFLUXD_STORAGE_MAX_INDEX_LOG_FILE_SIZE=1048576

Configuration file

YAML TOML JSON

storage-max-index-log-file-size: 1048576

storage-max-index-log-file-size = 1048576

{
  "storage-max-index-log-file-size": 1048576
}

storage-retention-check-interval

Interval of retention policy enforcement checks.

Default: 30m0s

influxd flag

influxd --storage-retention-check-interval=30m0s

Environment variable

export INFLUXD_STORAGE_MAX_INDEX_LOG_FILE_SIZE=30m0s

Configuration file

YAML TOML JSON

storage-retention-check-interval: 30m0s

storage-retention-check-interval = "30m0s"

{
  "storage-retention-check-interval": "30m0s"
}

storage-series-file-max-concurrent-snapshot-compactions

Maximum number of snapshot compactions that can run concurrently across all series partitions in a database.

Default: 0

influxd flag

influxd --storage-series-file-max-concurrent-snapshot-compactions=0

Environment variable

export INFLUXD_STORAGE_SERIES_FILE_MAX_CONCURRENT_SNAPSHOT_COMPACTIONS=0

Configuration file

YAML TOML JSON

storage-series-file-max-concurrent-snapshot-compactions: 0

storage-series-file-max-concurrent-snapshot-compactions = 0

{
  "storage-series-file-max-concurrent-snapshot-compactions": 0
}

storage-series-id-set-cache-size

Size of the internal cache used in the TSI index to store previously calculated series results. Cached results are returned quickly rather than needing to be recalculated when a subsequent query with the same tag key/value predicate is executed. Setting this value to 0 will disable the cache and may decrease query performance.

Default: 100

This value should only be increased if the set of regularly used tag key/value predicates across all measurements for a database is larger than 100. An increase in cache size may lead to an increase in heap usage.

influxd flag

influxd --storage-series-id-set-cache-size=100

Environment variable

export INFLUXD_STORAGE_SERIES_ID_SET_CACHE_SIZE=100

Configuration file

YAML TOML JSON

storage-series-id-set-cache-size: 100

storage-series-id-set-cache-size = 100

{
  "storage-series-id-set-cache-size": 100
}

storage-shard-precreator-advance-period

The time before a shard group’s end-time that the successor shard group is created.

Default: 30m0s

influxd flag

influxd --storage-shard-precreator-advance-period=30m0s

Environment variable

export INFLUXD_STORAGE_SHARD_PRECREATOR_ADVANCE_PERIOD=30m0s

Configuration file

YAML TOML JSON

storage-shard-precreator-advance-period: 30m0s

storage-shard-precreator-advance-period = "30m0s"

{
  "storage-shard-precreator-advance-period": "30m0s"
}

storage-shard-precreator-check-interval

Interval of pre-create new shards check.

Default: 10m0s

influxd flag

influxd --storage-shard-precreator-check-interval=10m0s

Environment variable

export INFLUXD_STORAGE_SHARD_PRECREATOR_CHECK_INTERVAL=10m0s

Configuration file

YAML TOML JSON

storage-shard-precreator-check-interval: 10m0s

storage-shard-precreator-check-interval = "10m0s"

{
  "storage-shard-precreator-check-interval": "10m0s"
}

storage-tsm-use-madv-willneed

Inform the kernel that InfluxDB intends to page in mmap’d sections of TSM files.

Default: false

influxd flag

influxd --storage-tsm-use-madv-willneed

Environment variable

export INFLUXD_STORAGE_TSM_USE_MADV_WILLNEED=true

Configuration file

YAML TOML JSON

storage-tsm-use-madv-willneed: true

storage-tsm-use-madv-willneed = true

{
  "storage-tsm-use-madv-willneed": true
}

storage-validate-keys

Validate incoming writes to ensure keys have only valid unicode characters.

Default: false

influxd flag

influxd --storage-validate-keys

Environment variable

export INFLUXD_STORAGE_VALIDATE_KEYS=true

Configuration file

YAML TOML JSON

storage-validate-keys: true

storage-validate-keys = true

{
  "storage-validate-keys": true
}

storage-wal-fsync-delay

Duration a write will wait before fsyncing. A duration greater than 0 batches multiple fsync calls. This is useful for slower disks or when WAL write contention is present.

Default: 0s

influxd flag

influxd --storage-wal-fsync-delay=0s

Environment variable

export INFLUXD_STORAGE_WAL_FSYNC_DELAY=0s

Configuration file

YAML TOML JSON

storage-wal-fsync-delay: 0s

storage-wal-fsync-delay = "0s"

{
  "storage-wal-fsync-delay": "0s"
}

store

Specifies the data store for REST resources.

Options: bolt, memory
Default: bolt

memory is meant for transient environments, such as testing environments, where data persistence does not matter. InfluxData does not recommend using memory in production.

influxd flag

influxd --store=bolt

Environment variable

export INFLUXD_STORE=bolt

Configuration file

YAML TOML JSON

store: bolt

store = "bolt"

{
  "store": "bolt"
}

tls-cert

Path to TLS certificate file. Requires the tls-key to be set.

For more information, see Enable TLS encryption.

influxd flag

influxd --tls-cert=/path/to/influxdb.crt

Environment variable

export INFLUXD_TLS_CERT=/path/to/influxdb.crt

Configuration file

YAML TOML JSON

tls-cert: /path/to/influxdb.crt

tls-cert = "/path/to/influxdb.crt"

{
  "tls-cert": "/path/to/influxdb.crt"
}

tls-key

Path to TLS key file. Requires the tls-cert to be set.

For more information, see Enable TLS encryption.

influxd flag

influxd --tls-key=/path/to/influxdb.key

Environment variable

export INFLUXD_TLS_KEY=/path/to/influxdb.key

Configuration file

YAML TOML JSON

tls-key: /path/to/influxdb.key

tls-key = "/path/to/influxdb.key"

{
  "tls-key": "/path/to/influxdb.key"
}

tls-min-version

Minimum accepted TLS version.

Default: 1.2

influxd flag

influxd --tls-min-version=1.2

Environment variable

export INFLUXD_TLS_MIN_VERSION=1.2

Configuration file

YAML TOML JSON

tls-min-version: "1.2"

tls-min-version = "1.2"

{
  "tls-min-version": "1.2"
}

tls-strict-ciphers

Restrict accepted TLS ciphers to:

• ECDHE_RSA_WITH_AES_256_GCM_SHA384
• ECDHE_RSA_WITH_AES_256_CBC_SHA
• RSA_WITH_AES_256_GCM_SHA384
• RSA_WITH_AES_256_CBC_SHA

Default: false

influxd flag

influxd --tls-strict-ciphers

Environment variable

export INFLUXD_TLS_STRICT_CIPHERS=true

Configuration file

YAML TOML JSON

tls-strict-ciphers: true

tls-strict-ciphers = true

{
  "tls-strict-ciphers": true
}

tracing-type

Enable tracing in InfluxDB and specifies the tracing type. Tracing is disabled by default.

Options: log, jaeger

influxd flag

influxd --tracing-type=log

Environment variable

export INFLUXD_TRACING_TYPE=log

Configuration file

YAML TOML JSON

tracing-type: log

tracing-type = "log"

{
  "tracing-type": "log"
}

vault-addr

Specifies the address of the Vault server expressed as a URL and port. For example: https://127.0.0.1:8200/.

influxd flag

influxd --vault-addr=https://127.0.0.1:8200/

Environment variable

export VAULT_ADDR=https://127.0.0.1:8200/

Configuration file

YAML TOML JSON

vault-addr: https://127.0.0.1:8200/

vault-addr = "https://127.0.0.1:8200/"

{
  "vault-addr": "https://127.0.0.1:8200/"
}

vault-cacert

Specifies the 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 setting takes precedence over the --vault-capath setting.

influxd flag

influxd  --vault-cacert=/path/to/ca.pem

Environment variable

export VAULT_CACERT=/path/to/ca.pem

Configuration file

YAML TOML JSON

vault-cacert: /path/to/ca.pem

vault-cacert = "/path/to/ca.pem"

{
  "vault-cacert": "/path/to/ca.pem"
}

vault-capath

Specifies the 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.

influxd flag

influxd --vault-capath=/path/to/certs/

Environment variable

export VAULT_CAPATH=/path/to/certs/

Configuration file

YAML TOML JSON

vault-capath: /path/to/certs/

vault-capath = "/path/to/certs/"

{
  "vault-capath": "/path/to/certs/"
}

vault-client-cert

Specifies the path to a PEM-encoded client certificate on the local disk. This file is used for TLS communication with the Vault server.

influxd flag

influxd --vault-client-cert=/path/to/client_cert.pem

Environment variable

export VAULT_CLIENT_CERT=/path/to/client_cert.pem

Configuration file

YAML TOML JSON

vault-client-cert: /path/to/client_cert.pem

vault-client-cert = "/path/to/client_cert.pem"

{
  "vault-client-cert": "/path/to/client_cert.pem"
}

vault-client-key

Specifies the path to an unencrypted, PEM-encoded private key on disk which corresponds to the matching client certificate.

influxd flag

influxd --vault-client-key=/path/to/private_key.pem

Environment variable

export VAULT_CLIENT_KEY=/path/to/private_key.pem

Configuration file

YAML TOML JSON

vault-client-key: /path/to/private_key.pem

vault-client-key = "/path/to/private_key.pem"

{
  "vault-client-key": "/path/to/private_key.pem"
}

vault-max-retries

Specifies the maximum number of retries when encountering a 5xx error code. The default is 2 (for three attempts in total). Set this to 0 or less to disable retrying.

Default: 2

influxd flag

influxd --vault-max-retries=2

Environment variable

export VAULT_MAX_RETRIES=2

Configuration file

YAML TOML JSON

vault-max-retries: 2

vault-max-retries = 2

{
  "vault-max-retries": 2
}

vault-client-timeout

Specifies the Vault client timeout.

Default: 60s

influxd flag

influxd --vault-client-timeout=60s

Environment variable

export VAULT_CLIENT_TIMEOUT=60s

Configuration file

YAML TOML JSON

vault-client-timeout: 60s

vault-client-timeout = "60s"

{
  "vault-client-timeout": "60s"
}

vault-skip-verify

Skip certificate verification when communicating with Vault. Setting this variable voids Vault’s security model and is not recommended.

Default: false

influxd flag

influxd --vault-skip-verify

Environment variable

export VAULT_SKIP_VERIFY=true

Configuration file

YAML TOML JSON

vault-skip-verify: true

vault-skip-verify = true

{
  "vault-skip-verify": true
}

vault-tls-server-name

Specifies the name to use as the Server Name Indication (SNI) host when connecting via TLS.

influxd flag

influxd --vault-tls-server-name=secure.example.com

Environment variable

export VAULT_TLS_SERVER_NAME=secure.example.com

Configuration file

YAML TOML JSON

vault-tls-server-name: secure.example.com

vault-tls-server-name = "secure.example.com"

{
  "vault-tls-server-name": "secure.example.com"
}

vault-token

Specifies the Vault authentication token use when authenticating with Vault.

influxd flag

influxd --vault-token=exAmple-t0ken-958a-f490-c7fd0eda5e9e

Environment variable

export VAULT_TOKEN=exAmple-t0ken-958a-f490-c7fd0eda5e9e

Configuration file

YAML TOML JSON

vault-token: exAmple-t0ken-958a-f490-c7fd0eda5e9e

vault-token = "exAmple-t0ken-958a-f490-c7fd0eda5e9e"

{
  "vault-token": "exAmple-t0ken-958a-f490-c7fd0eda5e9e"
}

Related articles

• influxd - InfluxDB service