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

12 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

Send a GET request to the /ping endpoint to examine HTTP response headers--for example:

# InfluxDB 3 (port 8181)
curl -i http://localhost:8181/ping

# InfluxDB v1/v2 (port 8086)
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,enterprise" %}}

InfluxDB 3 version detection

Check the version using the influxdb3 command:

influxdb3 --version

Send a GET request to the /ping endpoint to examine HTTP response headers--for example:

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

The response includes version information in the headers and body:

  • Headers:
    • x-influxdb-version: Version number (for example, {{% latest-patch %}})
    • x-influxdb-build: {{% show-in "core" %}}Core{{% /show-in %}}{{% show-in "enterprise" %}}Enterprise{{% /show-in %}}
  • JSON body: Contains version, revision, and process_id

Example response:

HTTP/1.1 200 OK
x-influxdb-build: {{% show-in "core" %}}Core{{% /show-in %}}{{% show-in "enterprise" %}}Enterprise{{% /show-in %}}
x-influxdb-version: {{% latest-patch %}}

{"version":"{{% latest-patch %}}","revision":"abc123def","process_id":"..."}

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

[!Note] The /ping endpoint requires authentication by default in InfluxDB 3 Enterprise. Use an admin token or a system token with system:ping:read permission. {{% /show-in %}}

{{% /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 %}}

{{% hide-in "v2,cloud,v1" %}}

[!Note]

SQL version() function

The SQL version() function returns the DataFusion query engine version, not the InfluxDB product version. Use the methods above to identify your InfluxDB version. {{% /hide-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

Check the version using the influxdb3 command:

influxdb3 --version

Send a GET request to the /ping endpoint to examine HTTP response headers--for example:

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

The response includes version information in the headers and body:

  • Headers:
    • x-influxdb-version: Version number (for example, 3.8.0)
    • x-influxdb-build: Core or Enterprise
  • JSON body: Contains version, revision, and process_id

Example response:

HTTP/1.1 200 OK
x-influxdb-build: Core
x-influxdb-version: 3.8.0

{"version":"3.8.0","revision":"abc123def","process_id":"..."}

[!Note] The /ping endpoint requires authentication by default in InfluxDB 3 Enterprise. Use an admin token or a system token with system:ping:read permission.

[!Note]

SQL version() function

The SQL version() function returns the DataFusion query engine version, not the InfluxDB product version. Use the methods above to identify your InfluxDB version.

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 (legacy) 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.