From cadd1bcb3b3ac750abe72c80d776e8bd51adcdf0 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 12:46:44 -0500 Subject: [PATCH 01/12] docs: update README tagline to identify InfluxDB v2 Replace generic tagline with version-specific description that identifies this as InfluxDB OSS v2 powered by the TSM storage engine. Improves discoverability for search engines and AI agents. --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index 69c35c233ce..b27a1cdd626 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,7 @@ InfluxDB Logo -

-InfluxDB is the leading open source time series database for metrics, events, and real-time analytics.

+

InfluxDB OSS v2 — open source time series platform powered by the TSM storage engine.

From 371103ad4c017a74a9668a7bf2db2dca4c7d89d2 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 12:59:27 -0500 Subject: [PATCH 02/12] docs: add version banner directing users to v3 Core Mirror the docs site banner tone to inform visitors that this branch is an earlier version and link to InfluxDB 3 Core with its v2/v1 compatibility APIs. --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index b27a1cdd626..3954e546f3e 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,9 @@ +> [!NOTE] +> This branch documents an earlier version of InfluxDB OSS. [InfluxDB 3 Core](https://github.com/influxdata/influxdb/tree/main) is the latest stable version. InfluxDB 3 Core includes [compatibility APIs for v2 and v1 write workloads](https://docs.influxdata.com/influxdb3/core/reference/api/). + ## Learn InfluxDB [Documentation](https://docs.influxdata.com/) | [Community Forum](https://community.influxdata.com/) | [Community Slack](https://www.influxdata.com/slack/) | [Blog](https://www.influxdata.com/blog/) | [InfluxDB University](https://university.influxdata.com/) | [YouTube](https://www.youtube.com/@influxdata8893) From a4205564b1bd93d7dd8ddeb0b0d4fa71e26daf8d Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 13:54:11 -0500 Subject: [PATCH 03/12] docs: add technical summary to README Add key-value style facts (version, branch, storage engine, query languages, API, compatibility, license, docs) for quick scanning by humans and AI agents. Matches the format used in PR #27315. --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index 3954e546f3e..234cbfd5730 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,15 @@ > [!NOTE] > This branch documents an earlier version of InfluxDB OSS. [InfluxDB 3 Core](https://github.com/influxdata/influxdb/tree/main) is the latest stable version. InfluxDB 3 Core includes [compatibility APIs for v2 and v1 write workloads](https://docs.influxdata.com/influxdb3/core/reference/api/). +**Version:** 2.x\ +**Branch:** `main-2.x`\ +**Storage engine:** TSM (Time-Structured Merge)\ +**Query languages:** Flux, InfluxQL\ +**API:** [v2 REST API](https://docs.influxdata.com/influxdb/v2/reference/api/) (write, query, manage)\ +**Compatible with:** InfluxDB 1.x write API and query (InfluxQL) API\ +**License:** [MIT](LICENSE)\ +**Documentation:** [docs.influxdata.com/influxdb/v2/](https://docs.influxdata.com/influxdb/v2/) + ## Learn InfluxDB [Documentation](https://docs.influxdata.com/) | [Community Forum](https://community.influxdata.com/) | [Community Slack](https://www.influxdata.com/slack/) | [Blog](https://www.influxdata.com/blog/) | [InfluxDB University](https://university.influxdata.com/) | [YouTube](https://www.youtube.com/@influxdata8893) From cc11af6b22e79b6a0a7f3884798217f0dac5ad69 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 13:55:21 -0500 Subject: [PATCH 04/12] docs: remove stale InfluxDB Cloud signup CTA New users can no longer sign up for InfluxDB Cloud (TSM). --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 234cbfd5730..28fe545a01c 100644 --- a/README.md +++ b/README.md @@ -23,8 +23,6 @@ ## Learn InfluxDB [Documentation](https://docs.influxdata.com/) | [Community Forum](https://community.influxdata.com/) | [Community Slack](https://www.influxdata.com/slack/) | [Blog](https://www.influxdata.com/blog/) | [InfluxDB University](https://university.influxdata.com/) | [YouTube](https://www.youtube.com/@influxdata8893) -Try **InfluxDB Cloud** for free and get started fast with no local setup required. Click [here](https://cloud2.influxdata.com/signup) to start building your application on InfluxDB Cloud. - ## Install We have nightly and versioned Docker images, Debian packages, RPM packages, and tarballs of InfluxDB available at the [InfluxData downloads page](https://portal.influxdata.com/downloads/). We also provide the `influx` command line interface (CLI) client as a separate binary available at the same location. From f9d1772007a449fd6bb1e78fbdfd8cb82f1a70fd Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 13:57:01 -0500 Subject: [PATCH 05/12] docs: clean up Install section wording --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 28fe545a01c..7b15ac2107f 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ ## Install -We have nightly and versioned Docker images, Debian packages, RPM packages, and tarballs of InfluxDB available at the [InfluxData downloads page](https://portal.influxdata.com/downloads/). We also provide the `influx` command line interface (CLI) client as a separate binary available at the same location. +For Docker images, Debian packages, RPM packages, and tarballs, see the [InfluxData downloads page](https://portal.influxdata.com/downloads/). The `influx` command line interface (CLI) client is available as a separate binary at the same location. If you are interested in building from source, see the [building from source](CONTRIBUTING.md#building-from-source) guide for contributors. From e79cf23539e39ff6623512659b96339fdfb642d7 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 13:58:23 -0500 Subject: [PATCH 06/12] docs: pin Get Started link to v2 docs The /influxdb/latest/ URL will eventually resolve to v3. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7b15ac2107f..1a17a25cfe4 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ For Docker images, Debian packages, RPM packages, and tarballs, see the [InfluxD If you are interested in building from source, see the [building from source](CONTRIBUTING.md#building-from-source) guide for contributors. ## Get Started -For a complete getting started guide, please see our full [online documentation site](https://docs.influxdata.com/influxdb/latest/). +For a complete getting started guide, see the [InfluxDB v2 documentation](https://docs.influxdata.com/influxdb/v2/get-started/). To write and query data or use the API in any way, you'll need to first create a user, credentials, organization, and bucket. Everything in InfluxDB is organized under a concept of an organization, as the API is designed to be multi-tenant. Buckets represent where you store time series data — they are synonymous with what was previously in InfluxDB 1.x’s database and retention policy. From 2b29b5f2f1ac01d71cc288f7ddd9c33355631da4 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 14:03:00 -0500 Subject: [PATCH 07/12] docs: rewrite Get Started description for clarity Consolidate three paragraphs into one concise description of the v2 data model (organizations, buckets) and setup options. --- README.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/README.md b/README.md index 1a17a25cfe4..47503d6dc0a 100644 --- a/README.md +++ b/README.md @@ -33,10 +33,7 @@ If you are interested in building from source, see the [building from source](CO For a complete getting started guide, see the [InfluxDB v2 documentation](https://docs.influxdata.com/influxdb/v2/get-started/). -To write and query data or use the API in any way, you'll need to first create a user, credentials, organization, and bucket. Everything in InfluxDB is organized under a concept of an organization, as the API is designed to be multi-tenant. Buckets represent where you store time series data — they are synonymous with what was previously in InfluxDB 1.x’s database and retention policy. - - -The simplest way to get set up is to point your browser to http://localhost:8086 and go through the prompts. +In InfluxDB v2, data and resources belong to an _organization_. You store time series data in _buckets_ (equivalent to a database and retention policy in InfluxDB 1.x). To get started, create a user, organization, and bucket — either through the UI at `http://localhost:8086` or with the `influx setup` CLI command. ## Flux Flux is an open source functional data scripting language designed for querying, analyzing, and acting on data. Flux is supported in InfluxDB 1.x and 2.x, but is not supported in v3. For users who are interested in transitioning to InfluxDB 3.0 and want to future-proof their code, we suggest using InfluxQL. From 21ce2324a0ddba1b200210e150f716c18e0198d6 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 14:15:47 -0500 Subject: [PATCH 08/12] docs: update Flux section with migration guidance Link Flux to its repo, clarify it is not supported in InfluxDB 3, and recommend InfluxQL for users planning to migrate. --- README.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/README.md b/README.md index 47503d6dc0a..fd257c034ab 100644 --- a/README.md +++ b/README.md @@ -36,10 +36,7 @@ For a complete getting started guide, see the [InfluxDB v2 documentation](https: In InfluxDB v2, data and resources belong to an _organization_. You store time series data in _buckets_ (equivalent to a database and retention policy in InfluxDB 1.x). To get started, create a user, organization, and bucket — either through the UI at `http://localhost:8086` or with the `influx setup` CLI command. ## Flux -Flux is an open source functional data scripting language designed for querying, analyzing, and acting on data. Flux is supported in InfluxDB 1.x and 2.x, but is not supported in v3. For users who are interested in transitioning to InfluxDB 3.0 and want to future-proof their code, we suggest using InfluxQL. - - -The source for Flux is [available on GitHub](https://github.com/influxdata/flux). +[Flux](https://github.com/influxdata/flux) is an open source functional data scripting language designed for querying, analyzing, and acting on data. Flux is supported in InfluxDB 1.x and 2.x, but is not supported in InfluxDB 3. If you plan to migrate to InfluxDB 3 in the future, we recommend using [InfluxQL](https://docs.influxdata.com/influxdb/v2/query-data/influxql/) instead of Flux with InfluxDB v2. ## Additional Resources - [InfluxDB Tips and Tutorials](https://www.influxdata.com/blog/category/tech/influxdb/) From 0bd9742fe8e6767270603cac502efad11fb0122e Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 14:17:58 -0500 Subject: [PATCH 09/12] docs: remove stale Additional Resources section Links to tutorials and courses are no longer relevant to v2. --- README.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/README.md b/README.md index fd257c034ab..b94d044850c 100644 --- a/README.md +++ b/README.md @@ -37,8 +37,3 @@ In InfluxDB v2, data and resources belong to an _organization_. You store time s ## Flux [Flux](https://github.com/influxdata/flux) is an open source functional data scripting language designed for querying, analyzing, and acting on data. Flux is supported in InfluxDB 1.x and 2.x, but is not supported in InfluxDB 3. If you plan to migrate to InfluxDB 3 in the future, we recommend using [InfluxQL](https://docs.influxdata.com/influxdb/v2/query-data/influxql/) instead of Flux with InfluxDB v2. - -## Additional Resources -- [InfluxDB Tips and Tutorials](https://www.influxdata.com/blog/category/tech/influxdb/) -- [InfluxDB Essentials Course](https://university.influxdata.com/courses/influxdb-essentials-tutorial/) -- [Exploring InfluxDB Cloud Course](https://university.influxdata.com/courses/exploring-influxdb-cloud-tutorial/) \ No newline at end of file From 6356ea12338bd8a0bac65ad314af871923b48b86 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 14:40:46 -0500 Subject: [PATCH 10/12] docs: add Other InfluxDB Versions branch table Map branches to versions with query languages and docs links, matching the format used on the main branch. --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index b94d044850c..405684ab9cb 100644 --- a/README.md +++ b/README.md @@ -37,3 +37,13 @@ In InfluxDB v2, data and resources belong to an _organization_. You store time s ## Flux [Flux](https://github.com/influxdata/flux) is an open source functional data scripting language designed for querying, analyzing, and acting on data. Flux is supported in InfluxDB 1.x and 2.x, but is not supported in InfluxDB 3. If you plan to migrate to InfluxDB 3 in the future, we recommend using [InfluxQL](https://docs.influxdata.com/influxdb/v2/query-data/influxql/) instead of Flux with InfluxDB v2. + +## Other InfluxDB Versions + +This repository contains multiple InfluxDB versions on separate branches: + +| Version | Branch | Query Languages | Documentation | +|---------|--------|-----------------|---------------| +| v3 Core | [`main`](https://github.com/influxdata/influxdb/tree/main) | SQL, InfluxQL | [docs.influxdata.com/influxdb3/core/](https://docs.influxdata.com/influxdb3/core/) | +| **v2.x (this branch)** | [`main-2.x`](https://github.com/influxdata/influxdb/tree/main-2.x) | Flux, InfluxQL | [docs.influxdata.com/influxdb/v2/](https://docs.influxdata.com/influxdb/v2/) | +| v1.x | [`master-1.x`](https://github.com/influxdata/influxdb/tree/master-1.x) | InfluxQL, Flux | [docs.influxdata.com/influxdb/v1/](https://docs.influxdata.com/influxdb/v1/) | From 69f87de7219c89cbd4f8bf6cdb22f539fad959c7 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 14:42:57 -0500 Subject: [PATCH 11/12] docs: remove Learn InfluxDB section General learning links are not specific to v2. --- README.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/README.md b/README.md index 405684ab9cb..0702123b3ab 100644 --- a/README.md +++ b/README.md @@ -20,9 +20,6 @@ **License:** [MIT](LICENSE)\ **Documentation:** [docs.influxdata.com/influxdb/v2/](https://docs.influxdata.com/influxdb/v2/) -## Learn InfluxDB -[Documentation](https://docs.influxdata.com/) | [Community Forum](https://community.influxdata.com/) | [Community Slack](https://www.influxdata.com/slack/) | [Blog](https://www.influxdata.com/blog/) | [InfluxDB University](https://university.influxdata.com/) | [YouTube](https://www.youtube.com/@influxdata8893) - ## Install For Docker images, Debian packages, RPM packages, and tarballs, see the [InfluxData downloads page](https://portal.influxdata.com/downloads/). The `influx` command line interface (CLI) client is available as a separate binary at the same location. From 9e7821dda8bf260b852bdf9ca88ea21bb3e4db0d Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Mon, 30 Mar 2026 14:49:06 -0500 Subject: [PATCH 12/12] docs: add Support section linking to v2 docs --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 0702123b3ab..15b3dc3ecc4 100644 --- a/README.md +++ b/README.md @@ -44,3 +44,7 @@ This repository contains multiple InfluxDB versions on separate branches: | v3 Core | [`main`](https://github.com/influxdata/influxdb/tree/main) | SQL, InfluxQL | [docs.influxdata.com/influxdb3/core/](https://docs.influxdata.com/influxdb3/core/) | | **v2.x (this branch)** | [`main-2.x`](https://github.com/influxdata/influxdb/tree/main-2.x) | Flux, InfluxQL | [docs.influxdata.com/influxdb/v2/](https://docs.influxdata.com/influxdb/v2/) | | v1.x | [`master-1.x`](https://github.com/influxdata/influxdb/tree/master-1.x) | InfluxQL, Flux | [docs.influxdata.com/influxdb/v1/](https://docs.influxdata.com/influxdb/v1/) | + +## Support + +For community support, feedback channels, and documentation requests, see [Support and feedback](https://docs.influxdata.com/influxdb/v2/get-started/#support-and-feedback).