--- title: influxdb3 serve description: The influxdb3 serve command starts the InfluxDB 3 Core server. url: https://docs.influxdata.com/influxdb3/core/reference/cli/influxdb3/serve/ estimated_tokens: 6678 product: InfluxDB 3 Core version: core publisher: InfluxData canonical: https://docs.influxdata.com/influxdb3/core/reference/cli/influxdb3/serve/ date: '2026-06-17T08:45:49-05:00' lastmod: '2026-06-17T08:45:49-05:00' --- The `influxdb3 serve` command starts the InfluxDB 3 Core server. ## Usage ```bash influxdb3 serve [OPTIONS] ``` ## Required Parameters * **node-id**: A unique identifier for your server instance. Must be unique for any hosts sharing the same object store. * **object-store**: Determines where time series data is stored. * Other object store parameters depending on the selected `object-store` type. > [!Note] > `--node-id` supports alphanumeric strings with optional hyphens. #### Global configuration options Some configuration options (like [`--num-io-threads`](/influxdb3/core/reference/config-options/#num-io-threads)) are **global** and must be specified **before** the `serve` command: ```bash influxdb3 --num-io-threads=8 serve --node-id=node0 --object-store=file --verbose ``` See [Global configuration options](/influxdb3/core/reference/config-options/#global-configuration-options) for the complete list. ## Options |Option| | Description | |------|----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------| | \* | `--node-id` | *See [configuration options](/influxdb3/core/reference/config-options/#node-id)* | | \* | `--object-store` | *See [configuration options](/influxdb3/core/reference/config-options/#object-store)* | | | `--admin-token-recovery-http-bind` | *See [configuration options](/influxdb3/core/reference/config-options/#admin-token-recovery-http-bind)* | | | `--admin-token-recovery-tcp-listener-file-path` | *See [configuration options](/influxdb3/core/reference/config-options/#admin-token-recovery-tcp-listener-file-path)* | | | `--admin-token-file` | *See [configuration options](/influxdb3/enterprise/reference/config-options/#admin-token-file)* | | | `--aws-access-key-id` | *See [configuration options](/influxdb3/core/reference/config-options/#aws-access-key-id)* | | | `--aws-allow-http` | *See [configuration options](/influxdb3/core/reference/config-options/#aws-allow-http)* | | | `--aws-credentials-file` | *See [configuration options](/influxdb3/enterprise/reference/config-options/#aws-credentials-file)* | | | `--aws-default-region` | *See [configuration options](/influxdb3/core/reference/config-options/#aws-default-region)* | | | `--aws-endpoint` | *See [configuration options](/influxdb3/core/reference/config-options/#aws-endpoint)* | | | `--aws-secret-access-key` | *See [configuration options](/influxdb3/core/reference/config-options/#aws-secret-access-key)* | | | `--aws-session-token` | *See [configuration options](/influxdb3/core/reference/config-options/#aws-session-token)* | | | `--aws-skip-signature` | *See [configuration options](/influxdb3/core/reference/config-options/#aws-skip-signature)* | | | `--azure-allow-http` | *See [configuration options](/influxdb3/enterprise/reference/config-options/#azure-allow-http)* | | | `--azure-endpoint` | *See [configuration options](/influxdb3/core/reference/config-options/#azure-endpoint)* | | | `--azure-storage-access-key` | *See [configuration options](/influxdb3/core/reference/config-options/#azure-storage-access-key)* | | | `--azure-storage-account` | *See [configuration options](/influxdb3/core/reference/config-options/#azure-storage-account)* | | | `--bucket` | *See [configuration options](/influxdb3/core/reference/config-options/#bucket)* | | | `--data-dir` | *See [configuration options](/influxdb3/core/reference/config-options/#data-dir)* | | | `--datafusion-config` | *See [configuration options](/influxdb3/core/reference/config-options/#datafusion-config)* | | | `--datafusion-max-parquet-fanout` | *See [configuration options](/influxdb3/core/reference/config-options/#datafusion-max-parquet-fanout)* | | | `--datafusion-num-threads` | *See [configuration options](/influxdb3/core/reference/config-options/#datafusion-num-threads)* | | | `--datafusion-runtime-disable-lifo-slot` | Development-only Tokio runtime configuration | | | `--datafusion-runtime-event-interval` | Development-only Tokio runtime configuration | | | `--datafusion-runtime-global-queue-interval` | Development-only Tokio runtime configuration | | | `--datafusion-runtime-max-blocking-threads` | Development-only Tokio runtime configuration | | | `--datafusion-runtime-max-io-events-per-tick` | Development-only Tokio runtime configuration | | | `--datafusion-runtime-thread-keep-alive` | Development-only Tokio runtime configuration | | | `--datafusion-runtime-thread-priority` | Development-only Tokio runtime configuration | | | `--datafusion-runtime-type` | Development-only Tokio runtime configuration | | | `--datafusion-use-cached-parquet-loader` | *See [configuration options](/influxdb3/core/reference/config-options/#datafusion-use-cached-parquet-loader)* | | | `--delete-grace-period` | *See [configuration options](/influxdb3/core/reference/config-options/#delete-grace-period)* | | | `--disable-authz` | *See [configuration options](/influxdb3/core/reference/config-options/#disable-authz)* | | | `--disable-parquet-mem-cache` | *See [configuration options](/influxdb3/core/reference/config-options/#disable-parquet-mem-cache)* | | | `--distinct-cache-eviction-interval` | *See [configuration options](/influxdb3/core/reference/config-options/#distinct-cache-eviction-interval)* | | | `--exec-mem-pool-bytes` | *See [configuration options](/influxdb3/core/reference/config-options/#exec-mem-pool-bytes)* | | | `--force-snapshot-mem-threshold` | *See [configuration options](/influxdb3/core/reference/config-options/#force-snapshot-mem-threshold)* | | | `--gen1-duration` | *See [configuration options](/influxdb3/core/reference/config-options/#gen1-duration)* | | | `--gen1-lookback-duration` | *See [configuration options](/influxdb3/core/reference/config-options/#gen1-lookback-duration)* | | | `--google-service-account` | *See [configuration options](/influxdb3/core/reference/config-options/#google-service-account)* | | | `--hard-delete-default-duration` | *See [configuration options](/influxdb3/core/reference/config-options/#hard-delete-default-duration)* | | `-h` | `--help` | Print help information | | | `--help-all` | Print detailed help information | | | `--http-bind` | *See [configuration options](/influxdb3/core/reference/config-options/#http-bind)* | | | `--last-cache-eviction-interval` | *See [configuration options](/influxdb3/core/reference/config-options/#last-cache-eviction-interval)* | | | `--log-destination` | *See [configuration options](/influxdb3/core/reference/config-options/#log-destination)* | | | `--log-filter` | *See [configuration options](/influxdb3/core/reference/config-options/#log-filter)* | | | `--log-format` | *See [configuration options](/influxdb3/core/reference/config-options/#log-format)* | | | `--max-concurrent-queries` | *See [configuration options](/influxdb3/core/reference/config-options/#max-concurrent-queries)* | | | `--max-http-request-size` | *See [configuration options](/influxdb3/core/reference/config-options/#max-http-request-size)* | | | `--object-store-cache-endpoint` | *See [configuration options](/influxdb3/core/reference/config-options/#object-store-cache-endpoint)* | | | `--object-store-connection-limit` | *See [configuration options](/influxdb3/core/reference/config-options/#object-store-connection-limit)* | | | `--object-store-http2-max-frame-size` | *See [configuration options](/influxdb3/core/reference/config-options/#object-store-http2-max-frame-size)* | | | `--object-store-http2-only` | *See [configuration options](/influxdb3/core/reference/config-options/#object-store-http2-only)* | | | `--object-store-max-retries` | *See [configuration options](/influxdb3/core/reference/config-options/#object-store-max-retries)* | | | `--object-store-retry-timeout` | *See [configuration options](/influxdb3/core/reference/config-options/#object-store-retry-timeout)* | | | `--package-manager` | *See [configuration options](/influxdb3/core/reference/config-options/#package-manager)* | | | `--parquet-mem-cache-prune-interval` | *See [configuration options](/influxdb3/core/reference/config-options/#parquet-mem-cache-prune-interval)* | | | `--parquet-mem-cache-prune-percentage` | *See [configuration options](/influxdb3/core/reference/config-options/#parquet-mem-cache-prune-percentage)* | | | `--parquet-mem-cache-query-path-duration` | *See [configuration options](/influxdb3/core/reference/config-options/#parquet-mem-cache-query-path-duration)* | | | `--parquet-mem-cache-size` | *See [configuration options](/influxdb3/core/reference/config-options/#parquet-mem-cache-size)* | | | `--plugin-dir` | *See [configuration options](/influxdb3/core/reference/config-options/#plugin-dir)* | | | `--preemptive-cache-age` | *See [configuration options](/influxdb3/core/reference/config-options/#preemptive-cache-age)* | | | `--query-file-limit` | *See [configuration options](/influxdb3/core/reference/config-options/#query-file-limit)* | | | `--query-log-size` | *See [configuration options](/influxdb3/core/reference/config-options/#query-log-size)* | | | `--restrict-plugin-triggers-to` | *See [configuration options](/influxdb3/core/reference/config-options/#restrict-plugin-triggers-to)* | | | `--retention-check-interval` | *See [configuration options](/influxdb3/core/reference/config-options/#retention-check-interval)* | | | `--snapshotted-wal-files-to-keep` | *See [configuration options](/influxdb3/core/reference/config-options/#snapshotted-wal-files-to-keep)* | | | `--table-index-cache-concurrency-limit` | *See [configuration options](/influxdb3/core/reference/config-options/#table-index-cache-concurrency-limit)* | | | `--table-index-cache-max-entries` | *See [configuration options](/influxdb3/core/reference/config-options/#table-index-cache-max-entries)* | | | `--tcp-listener-file-path` | *See [configuration options](/influxdb3/core/reference/config-options/#tcp-listener-file-path)* | | | `--telemetry-disable-upload` | *See [configuration options](/influxdb3/core/reference/config-options/#disable-telemetry-upload)* | | | `--telemetry-endpoint` | *See [configuration options](/influxdb3/core/reference/config-options/#telemetry-endpoint)* | | | `--tls-cert` | *See [configuration options](/influxdb3/core/reference/config-options/#tls-cert)* | | | `--tls-key` | *See [configuration options](/influxdb3/core/reference/config-options/#tls-key)* | | | `--tls-minimum-version` | *See [configuration options](/influxdb3/core/reference/config-options/#tls-minimum-version)* | | | `--traces-exporter` | *See [configuration options](/influxdb3/core/reference/config-options/#traces-exporter)* | | | `--traces-exporter-jaeger-agent-host` | *See [configuration options](/influxdb3/core/reference/config-options/#traces-exporter-jaeger-agent-host)* | | | `--traces-exporter-jaeger-agent-port` | *See [configuration options](/influxdb3/core/reference/config-options/#traces-exporter-jaeger-agent-port)* | | | `--traces-exporter-jaeger-service-name` | *See [configuration options](/influxdb3/core/reference/config-options/#traces-exporter-jaeger-service-name)* | | |`--traces-exporter-jaeger-trace-context-header-name`|*See [configuration options](/influxdb3/core/reference/config-options/#traces-exporter-jaeger-trace-context-header-name)*| | | `--traces-jaeger-debug-name` | *See [configuration options](/influxdb3/core/reference/config-options/#traces-jaeger-debug-name)* | | | `--traces-jaeger-max-msgs-per-second` | *See [configuration options](/influxdb3/core/reference/config-options/#traces-jaeger-max-msgs-per-second)* | | | `--traces-jaeger-tags` | *See [configuration options](/influxdb3/core/reference/config-options/#traces-jaeger-tags)* | | | `--virtual-env-location` | *See [configuration options](/influxdb3/core/reference/config-options/#virtual-env-location)* | | | `--wal-flush-interval` | *See [configuration options](/influxdb3/core/reference/config-options/#wal-flush-interval)* | | | `--wal-max-write-buffer-size` | *See [configuration options](/influxdb3/core/reference/config-options/#wal-max-write-buffer-size)* | | | `--wal-replay-concurrency-limit` | *See [configuration options](/influxdb3/core/reference/config-options/#wal-replay-concurrency-limit)* | | | `--wal-replay-fail-on-error` | *See [configuration options](/influxdb3/core/reference/config-options/#wal-replay-fail-on-error)* | | | `--wal-snapshot-size` | *See [configuration options](/influxdb3/core/reference/config-options/#wal-snapshot-size)* | | | `--without-auth` | *See [configuration options](/influxdb3/core/reference/config-options/#without-auth)* | ### Option environment variables You can use environment variables to define most `influxdb3 serve` options. For more information, see[Configuration options](/influxdb3/core/reference/config-options/). ## Quick-Start Mode For development, testing, and home use, you can start InfluxDB 3 Core by running `influxdb3` without the `serve` subcommand or any configuration parameters. The system automatically generates required values: * **`node-id`**: `{hostname}-node` (fallback: `primary-node`) * **`object-store`**: `file` * **`data-dir`**: `~/.influxdb` The system displays warning messages showing the auto-generated identifiers: ``` Using auto-generated node id: mylaptop-node. For production deployments, explicitly set --node-id ``` ### Quick-start examples ```bash # Zero-config startup influxdb3 # Override specific defaults influxdb3 --object-store memory # Use environment variables to override defaults INFLUXDB3_NODE_IDENTIFIER_PREFIX=my-node influxdb3 ``` #### Production deployments Quick-start mode is designed for development and testing environments. For production deployments, use explicit configuration with the `serve` subcommand and specify all required parameters as shown in the [Examples](#examples) below. **Configuration precedence**: CLI flags \> environment variables \> auto-generated defaults For more information about quick-start mode, see [Get started](/influxdb3/core/get-started/setup/#quick-start-mode-development). ## Examples * [Run the InfluxDB 3 server](#run-the-influxdb-3-server) * [Run the InfluxDB 3 server with extra verbose logging](#run-the-influxdb-3-server-with-extra-verbose-logging) * [Run InfluxDB 3 with debug logging using LOG\_FILTER](#run-influxdb-3-with-debug-logging-using-log_filter) In the examples below, replace`my-host-01`: with a unique string that identifies your InfluxDB 3 Core server. ### Run the InfluxDB 3 server ```bash influxdb3 serve \ --object-store file \ --data-dir ~/.influxdb3 \ --node-id my-host-01 ``` ### Run the InfluxDB 3 server with extra verbose logging ```bash influxdb3 serve \ --object-store file \ --data-dir ~/.influxdb3 \ --node-id my-host-01 --verbose ``` ### Run InfluxDB 3 with debug logging using LOG\_FILTER ```bash LOG_FILTER=debug influxdb3 serve \ --object-store file \ --data-dir ~/.influxdb3 \ --node-id my-host-01 ``` ## Troubleshooting ### Common Issues * **Error: “Failed to connect to object store”** Verify your `--object-store` setting and ensure all required parameters for that storage type are provided. * **Permission errors when using S3, Google Cloud, or Azure storage** Check that your authentication credentials are correct and have sufficient permissions. #### Related * [InfluxDB 3 Core configuration options](/influxdb3/core/reference/config-options/) | Option | | Description | | --- | --- | --- | | Option | | Description | | * | --node-id | See configuration options | | * | --object-store | See configuration options | | | --admin-token-recovery-http-bind | See configuration options | | | --admin-token-recovery-tcp-listener-file-path | See configuration options | | | --admin-token-file | See configuration options | | | --aws-access-key-id | See configuration options | | | --aws-allow-http | See configuration options | | | --aws-credentials-file | See configuration options | | | --aws-default-region | See configuration options | | | --aws-endpoint | See configuration options | | | --aws-secret-access-key | See configuration options | | | --aws-session-token | See configuration options | | | --aws-skip-signature | See configuration options | | | --azure-allow-http | See configuration options | | | --azure-endpoint | See configuration options | | | --azure-storage-access-key | See configuration options | | | --azure-storage-account | See configuration options | | | --bucket | See configuration options | | | --data-dir | See configuration options | | | --datafusion-config | See configuration options | | | --datafusion-max-parquet-fanout | See configuration options | | | --datafusion-num-threads | See configuration options | | | --datafusion-runtime-disable-lifo-slot | Development-only Tokio runtime configuration | | | --datafusion-runtime-event-interval | Development-only Tokio runtime configuration | | | --datafusion-runtime-global-queue-interval | Development-only Tokio runtime configuration | | | --datafusion-runtime-max-blocking-threads | Development-only Tokio runtime configuration | | | --datafusion-runtime-max-io-events-per-tick | Development-only Tokio runtime configuration | | | --datafusion-runtime-thread-keep-alive | Development-only Tokio runtime configuration | | | --datafusion-runtime-thread-priority | Development-only Tokio runtime configuration | | | --datafusion-runtime-type | Development-only Tokio runtime configuration | | | --datafusion-use-cached-parquet-loader | See configuration options | | | --delete-grace-period | See configuration options | | | --disable-authz | See configuration options | | | --disable-parquet-mem-cache | See configuration options | | | --distinct-cache-eviction-interval | See configuration options | | | --exec-mem-pool-bytes | See configuration options | | | --force-snapshot-mem-threshold | See configuration options | | | --gen1-duration | See configuration options | | | --gen1-lookback-duration | See configuration options | | | --google-service-account | See configuration options | | | --hard-delete-default-duration | See configuration options | | -h | --help | Print help information | | | --help-all | Print detailed help information | | | --http-bind | See configuration options | | | --last-cache-eviction-interval | See configuration options | | | --log-destination | See configuration options | | | --log-filter | See configuration options | | | --log-format | See configuration options | | | --max-concurrent-queries | See configuration options | | | --max-http-request-size | See configuration options | | | --object-store-cache-endpoint | See configuration options | | | --object-store-connection-limit | See configuration options | | | --object-store-http2-max-frame-size | See configuration options | | | --object-store-http2-only | See configuration options | | | --object-store-max-retries | See configuration options | | | --object-store-retry-timeout | See configuration options | | | --package-manager | See configuration options | | | --parquet-mem-cache-prune-interval | See configuration options | | | --parquet-mem-cache-prune-percentage | See configuration options | | | --parquet-mem-cache-query-path-duration | See configuration options | | | --parquet-mem-cache-size | See configuration options | | | --plugin-dir | See configuration options | | | --preemptive-cache-age | See configuration options | | | --query-file-limit | See configuration options | | | --query-log-size | See configuration options | | | --restrict-plugin-triggers-to | See configuration options | | | --retention-check-interval | See configuration options | | | --snapshotted-wal-files-to-keep | See configuration options | | | --table-index-cache-concurrency-limit | See configuration options | | | --table-index-cache-max-entries | See configuration options | | | --tcp-listener-file-path | See configuration options | | | --telemetry-disable-upload | See configuration options | | | --telemetry-endpoint | See configuration options | | | --tls-cert | See configuration options | | | --tls-key | See configuration options | | | --tls-minimum-version | See configuration options | | | --traces-exporter | See configuration options | | | --traces-exporter-jaeger-agent-host | See configuration options | | | --traces-exporter-jaeger-agent-port | See configuration options | | | --traces-exporter-jaeger-service-name | See configuration options | | | --traces-exporter-jaeger-trace-context-header-name | See configuration options | | | --traces-jaeger-debug-name | See configuration options | | | --traces-jaeger-max-msgs-per-second | See configuration options | | | --traces-jaeger-tags | See configuration options | | | --virtual-env-location | See configuration options | | | --wal-flush-interval | See configuration options | | | --wal-max-write-buffer-size | See configuration options | | | --wal-replay-concurrency-limit | See configuration options | | | --wal-replay-fail-on-error | See configuration options | | | --wal-snapshot-size | See configuration options | | | --without-auth | See configuration options |