Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
docs-v2/content/shared/identify-version.md

11 KiB
Raw Blame History

Identifying which InfluxDB product and version you're using is essential for accessing the correct documentation, troubleshooting issues, and planning upgrades.

!Note]
{{< influxdb-version-detector >}}

Quick detection methods

{{% hide-in "core,enterprise,cloud-serverless,cloud-dedicated,clustered,v2,cloud,v1" %}}

By URL pattern

If you access InfluxDB via a URL, the hostname often indicates which product you're using:

URL Pattern Product
*.influxdb.io InfluxDB Cloud Dedicated
us-east-1-1.aws.cloud2.influxdata.com InfluxDB Cloud Serverless
eu-central-1-1.aws.cloud2.influxdata.com InfluxDB Cloud Serverless
*.influxcloud.net InfluxDB Cloud 1 (legacy)
Other *.cloud2.influxdata.com regions InfluxDB Cloud (TSM)

By default port

Different InfluxDB products use different default ports:

  • Port 8181: InfluxDB 3 (Core or Enterprise)
  • Port 8086: InfluxDB v1 or v2

By HTTP headers

Check the /ping endpoint to examine HTTP response headers:

curl -i http://localhost:8086/ping

The response headers reveal your InfluxDB product:

Headers Product
x-influxdb-version: ^3.*
x-influxdb-build: Core		 InfluxDB 3 Core
x-influxdb-version: ^3.*
x-influxdb-build: Enterprise		 InfluxDB 3 Enterprise
x-influxdb-version: ^2.*
x-influxdb-build: OSS		 InfluxDB OSS v2
x-influxdb-version: ^1.*
x-influxdb-build: OSS		 InfluxDB OSS v1
x-influxdb-build: Enterprise
(with v1 version)		 InfluxDB Enterprise v1

{{% /hide-in %}}

{{% show-in "core" %}}

InfluxDB 3 Core detection

Check the version using the influxdb3 command:

influxdb3 --version

Query the /health endpoint:

curl http://localhost:8181/health

Check the /ping endpoint headers:

curl -i http://localhost:8181/ping

Look for:

  • x-influxdb-version: Version number (for example, 3.6.0)
  • x-influxdb-build: Core

{{% /show-in %}}

{{% show-in "enterprise" %}}

InfluxDB 3 Enterprise detection

Check the version using the influxdb3 command:

influxdb3 --version

Query the /health endpoint:

curl http://localhost:8181/health

Check the /ping endpoint headers:

curl -i http://localhost:8181/ping

Look for:

  • x-influxdb-version: Version number (for example, 3.6.0)
  • x-influxdb-build: Enterprise

{{% /show-in %}}

{{% show-in "clustered" %}}

InfluxDB Clustered detection

Use the influxctl CLI to check your cluster version:

influxctl version

To view cluster information:

influxctl cluster list

{{% /show-in %}}

{{% show-in "cloud-serverless" %}}

InfluxDB Cloud Serverless detection

InfluxDB Cloud Serverless can be identified by:

URL patterns:

  • us-east-1-1.aws.cloud2.influxdata.com
  • eu-central-1-1.aws.cloud2.influxdata.com

Account settings: Check your InfluxDB Cloud account dashboard for product and version details.

HTTP headers: API responses include version information in response headers.

{{% /show-in %}}

{{% show-in "cloud-dedicated" %}}

InfluxDB Cloud Dedicated detection

InfluxDB Cloud Dedicated can be identified by:

URL pattern: *.influxdb.io

  • Example: cluster-id.a.influxdb.io

Account settings: Check your InfluxDB Cloud Dedicated account dashboard for cluster and version details.

HTTP headers: API responses include version information in response headers.

{{% /show-in %}}

{{% show-in "v2" %}}

InfluxDB OSS v2 detection

Check the version using influxd:

influxd version

Query the /health endpoint and extract the version:

curl -s http://localhost:8086/health | jq -r '.version'

The InfluxDB UI displays the version:

  • On the login page
  • In the right column of the main landing page
  • In the user menu dropdown

For more details, see How can I identify my InfluxDB version?

{{% /show-in %}}

{{% show-in "cloud" %}}

InfluxDB Cloud (TSM) detection

InfluxDB Cloud (TSM) can be identified by:

URL patterns (regional cloud2.influxdata.com URLs, excluding Serverless regions):

  • us-west-2-1.aws.cloud2.influxdata.com
  • us-west-2-2.aws.cloud2.influxdata.com
  • us-east-1-2.aws.cloud2.influxdata.com (note: different from Serverless)
  • us-central1-1.gcp.cloud2.influxdata.com
  • westeurope-1.azure.cloud2.influxdata.com
  • eastus-1.azure.cloud2.influxdata.com

Account settings: Check your InfluxDB Cloud account dashboard for product details.

HTTP headers: API responses include version information in response headers.

{{% /show-in %}}

{{% show-in "v1" %}}

InfluxDB OSS v1 / Enterprise v1 detection

Check the version using influxd:

influxd version

Check the /ping endpoint headers:

curl -i http://localhost:8086/ping

Look for the x-influxdb-version header (for example, 1.11.7).

For Enterprise v1, the x-influxdb-build header will show Enterprise.

{{% /show-in %}}

{{% hide-in "core,enterprise,cloud-serverless,cloud-dedicated,clustered,v2,cloud,v1" %}}

Product-specific methods

InfluxDB 3 Core and Enterprise

{{< tabs-wrapper >}} {{% tabs %}} Command line Health endpoint HTTP headers {{% /tabs %}}

{{% tab-content %}}

Check the version using the influxdb3 command:

influxdb3 --version

{{% /tab-content %}}

{{% tab-content %}}

Query the /health endpoint:

curl http://localhost:8181/health

The response includes version information and build details.

{{% /tab-content %}}

{{% tab-content %}}

Check the /ping endpoint headers:

curl -i http://localhost:8181/ping

Look for:

  • x-influxdb-version: Version number (for example, 3.6.0)
  • x-influxdb-build: Core or Enterprise

{{% /tab-content %}}

{{< /tabs-wrapper >}}

InfluxDB Clustered

Use the influxctl CLI to check your cluster version:

influxctl version

To view cluster information:

influxctl cluster list

InfluxDB OSS v2

{{< tabs-wrapper >}} {{% tabs %}} Command line Health API User interface {{% /tabs %}}

{{% tab-content %}}

Check the version using influxd:

influxd version

Example output:

InfluxDB 2.7.12 (git: x0x000xx0x) build_date: 2024-MM-DDThh:mm:ssZ

{{% /tab-content %}}

{{% tab-content %}}

Query the /health endpoint and extract the version:

curl -s http://localhost:8086/health | jq -r '.version'

{{% /tab-content %}}

{{% tab-content %}}

The InfluxDB UI displays the version:

  • On the login page
  • In the right column of the main landing page
  • In the user menu dropdown

{{% /tab-content %}}

{{< /tabs-wrapper >}}

For more details, see How can I identify my InfluxDB version?

InfluxDB Cloud (Serverless, Dedicated, TSM)

For InfluxDB Cloud products, check the version information:

  • Account settings: Version details appear in your account dashboard
  • UI footer: The version may be displayed at the bottom of the web interface
  • HTTP headers: API responses include version headers
  • URL pattern: See By URL pattern above

InfluxDB OSS v1 and Enterprise v1

{{< tabs-wrapper >}} {{% tabs %}} Command line HTTP API {{% /tabs %}}

{{% tab-content %}}

Check the version using influxd:

influxd version

{{% /tab-content %}}

{{% tab-content %}}

Check the /ping endpoint headers:

curl -i http://localhost:8086/ping

Look for the x-influxdb-version header (for example, 1.11.7).

{{% /tab-content %}}

{{< /tabs-wrapper >}}

{{% /hide-in %}}

{{% hide-in "core,enterprise,cloud-serverless,cloud-dedicated,clustered,v2,cloud,v1,enterprise-v1" %}}

Understanding InfluxDB products

InfluxData offers multiple InfluxDB products to suit different use cases:

Product License Hosting Query Languages Default Port
InfluxDB 3 Core Free Self-hosted SQL, InfluxQL 8181
InfluxDB 3 Enterprise Paid Self-hosted SQL, InfluxQL 8181
InfluxDB Cloud Serverless Free/Paid Cloud SQL, InfluxQL, Flux N/A
InfluxDB Cloud Dedicated Paid Cloud SQL, InfluxQL N/A
InfluxDB Clustered Paid Self-hosted (Kubernetes) SQL, InfluxQL Custom
InfluxDB OSS v2 Free Self-hosted InfluxQL, Flux 8086
InfluxDB Cloud (TSM) Free/Paid Cloud InfluxQL, Flux N/A
InfluxDB OSS v1 Free Self-hosted InfluxQL 8086
InfluxDB Enterprise v1 Paid Self-hosted InfluxQL, Flux 8086
InfluxDB Cloud 1 Paid Cloud InfluxQL N/A

Key characteristics

  • InfluxDB 3 products use SQL and InfluxQL, run on port 8181 (self-hosted), and provide improved performance and scalability
  • InfluxDB v2 products use InfluxQL and Flux, run on port 8086 (self-hosted), and use a bucket-based data model
  • InfluxDB v1 products use InfluxQL, run on port 8086 (self-hosted), and use a database-based data model

{{% /hide-in %}}

Understanding InfluxDB products

For a complete comparison of InfluxDB versions and deployment options, see the InfluxDB platform overview.

Troubleshooting

Can't access your InfluxDB instance?

If you can't directly access your InfluxDB instance:

  1. Use the interactive version detector above or {{< ask-ai-link link-text="Ask InfluxData AI" query="Help determine my InfluxDB version based on licensing, hosting, server age, and API." >}}
  2. Answer questions about your setup:
    • License type (paid or free)
    • Hosting model (cloud or self-hosted)
    • Server age
    • Query language preferences
  3. Get product recommendations based on your answers

Still not sure?

If you're still uncertain, see the Support and feedback options.