docs: Revise README content and IMAGE tags:

  1. Updated content.md with the new structure and major version tags.
  2. Use `1.11` tags until `1.12` release or new `1` major version tags are published.
  3. Fixed compose.yaml to use port 8181 directly
  4. Updated variant files to use %%IMAGE%%:1-data and %%IMAGE%%:1-meta (these don't seem to be used)
  5. Removed references to latest tag from v2 description
  6. Created GitHub issue #820 in influxdata/influxdata-docker requesting to create generic v1 tags

Author: jstirnaman

influxdb/compose.yaml

@@ -5,7 +5,7 @@ services:
     container_name: influxdb3-core
     image: influxdb:3-core
     ports:
-      - 8282:8181
+      - 8181:8181
     command:
       - influxdb3
       - serve

influxdb/content.md

@@ -4,192 +4,132 @@
 
 InfluxDB is the time series database platform designed to collect, store, and process large amounts of event and time series data. Ideal for monitoring (sensors, servers, applications, networks), financial analytics, and behavioral tracking.
 
-**This README covers all currently supported versions of InfluxDB:**
+## Quick Start
 
--	InfluxDB 3: `%%IMAGE%%:3-core`, `%%IMAGE%%:3-enterprise`
--	InfluxDB v2: `%%IMAGE%%:2`
--	InfluxDB v1: `%%IMAGE%%:1.11`
--	InfluxDB Enterprise v1: `%%IMAGE%%:1.11-data` and `%%IMAGE%%:1.11-meta`
+Use InfluxDB 3 Core, the latest InfluxDB OSS:
 
-Find a specific InfluxDB version below for startup examples and links to full documentation.
+```console
+docker run -d -p 8181:8181 %%IMAGE%%:3-core
+```
 
-## How to use InfluxDB 3 images
+Available OSS tags:
 
-InfluxDB 3 is the latest version and features Apache Arrow, DataFusion SQL, and object storage for sub-10ms queries and unlimited cardinality. The InfluxDB 3 Core and InfluxDB 3 Enterprise editions both support SQL and InfluxQL queries, include the Python processing engine, and work with the InfluxDB 3 Explorer UI.
+-	`%%IMAGE%%:3-core` - **Latest InfluxDB OSS** (InfluxDB 3 Core)
+-	`%%IMAGE%%:2` - Previous generation OSS (InfluxDB v2)
+-	`%%IMAGE%%:1.11` - InfluxDB v1
 
--	**Core** (free, open source): For real-time monitoring and recent data. Covered in this guide.
--	**Enterprise** (requires a license): Adds historical data, clustering, HA, and security. See the InfluxData documentation to [Get started with InfluxDB 3 Enterprise](https://docs.influxdata.com/influxdb3/enterprise/get-started/).
+## Available Versions
 
-### Start InfluxDB 3
+#### InfluxDB 3 Core (`%%IMAGE%%:3-core`) - Latest OSS
 
-%%COMPOSE%%
+-	**Latest generation** with the InfluxDB 3 storage engine, Apache Arrow, and DataFusion SQL
+-	Sub-10ms queries and unlimited cardinality
+-	Supports SQL and InfluxQL queries
+-	Includes Python processing engine
+-	Designed for real-time monitoring and recent data
+-	Includes v1 compatibility API for writing and querying data
+-	Includes v2 compatibility API for writing data
 
-The example `compose.yaml` defines a service for InfluxDB 3 Core and configures file system volumes for data persistence and plugin storage.
+#### InfluxDB v2 (`%%IMAGE%%:2`)
 
-#### InfluxDB 3 server options
+-	Built on the TSM storage engine
+-	Supports Flux query language
+-	Integrated UI and dashboards
+-	Includes v1 compatibility API that supports InfluxQL
 
-You can customize the example, such as changing the node ID or object store type (for example, `s3`). See the full list of server options:
+#### InfluxDB v1 (`%%IMAGE%%:1.11`)
 
-```bash
-# InfluxDB 3 Core help
-docker run --pull --rm %%IMAGE%%:3-core influxdb3 serve --help
-```
+-	Built on the TSM storage engine
+-	Original version with InfluxQL query language
+-	Proven stability for existing deployments
 
-[InfluxDB 3 Core `serve` command](https://docs.influxdata.com/influxdb3/core/reference/clis/influxdb3/serve/)
+### Enterprise Editions (License Required)
 
-### Get started using InfluxDB 3
+#### InfluxDB 3 Enterprise (`%%IMAGE%%:3-enterprise`)
 
-After starting your InfluxDB 3 server, follow the guide to create an auth token and database, and write, query, and process data in InfluxDB 3:
+-	Adds unlimited data retention, compaction, clustering, and high availability to InfluxDB 3 Core
 
--	[Get started with InfluxDB 3 Core](https://docs.influxdata.com/influxdb3/core/get-started/)
--	Use the [InfluxDB 3 Explorer UI](https://docs.influxdata.com/influxdb3/explorer/) to write data, create dashboards, explore metrics, and manage your databases.
+For setup instructions, see the [InfluxDB 3 Enterprise installation documentation](https://docs.influxdata.com/influxdb3/enterprise/install/).
 
-## How to use the InfluxDB v2 image
+#### InfluxDB v1 Enterprise
 
-*InfluxDB v2 is an earlier version of InfluxDB OSS. InfluxDB 3 Core is the latest stable version.*
+-	`%%IMAGE%%:1.11-data` - Data nodes for clustering
+-	`%%IMAGE%%:1.11-meta` - Meta nodes for cluster coordination (port 8091)
 
-Run [InfluxDB v2](https://docs.influxdata.com/influxdb/v2/) using the Docker CLI with the following command:
-
-```bash
-docker run -d -p 8086:8086 \
-  -v $PWD/data:/var/lib/influxdb2 \
-  -v $PWD/config:/etc/influxdb2 \
-  -e DOCKER_INFLUXDB_INIT_MODE=setup \
-  -e DOCKER_INFLUXDB_INIT_USERNAME=my-user \
-  -e DOCKER_INFLUXDB_INIT_PASSWORD=my-password \
-  -e DOCKER_INFLUXDB_INIT_ORG=my-org \
-  -e DOCKER_INFLUXDB_INIT_BUCKET=my-bucket \
-  %%IMAGE%%:2
-```
+For setup instructions, see the [InfluxDB v1 Enterprise Docker documentation](https://docs.influxdata.com/enterprise_influxdb/v1/introduction/installation/docker/).
 
-After the container starts, visit [http://localhost:8086](http://localhost:8086) in your browser to view the UI.
+## Version Compatibility
 
-For detailed instructions, see the [InfluxDB v2 Docker Compose documentation](https://docs.influxdata.com/influxdb/v2/install/use-docker-compose/).
+### Migration Paths
 
-For more information about `DOCKER_INFLUXDB_INIT_*` environment variables, see the [InfluxDB v2 upgrade documentation](https://docs.influxdata.com/influxdb/v2/install/upgrade/v1-to-v2/docker/).
+To migrate from v1 or v2 to InfluxDB 3:
 
-## How to use the InfluxDB v1 Docker image
+1.	Dual-write new data to v1/v2 and InfluxDB 3.
+2.	Query historical data from v1/v2 and write it to InfluxDB 3. *InfluxDB 3 Enterprise is recommended for historical query capability.*
 
-*InfluxDB v1 is an earlier version of InfluxDB OSS. InfluxDB 3 Core is the latest stable version.*
+## Using InfluxDB 3 Core (Latest OSS)
 
-Run [InfluxDB v1](https://docs.influxdata.com/influxdb/v1/) using the Docker CLI:
+### Start InfluxDB 3 Core
 
-```bash
-docker run -d -p 8086:8086 \
-  -v $PWD:/var/lib/influxdb \
-  %%IMAGE%%:1.11
-```
+%%COMPOSE%%
 
-This command maps port `8086` and mounts your current directory to persist data.
+The example `compose.yaml` starts InfluxDB 3 Core on port 8181 with:
 
-For more information, see the [InfluxDB v1 Docker documentation](https://docs.influxdata.com/influxdb/v1/introduction/install/docker/).
+-	Data persistence at `/var/lib/influxdb3`
+-	Plugin directory for Python processing engine
+-	Object storage configured (default: file)
 
-## How to use the InfluxDB Enterprise v1 Docker image
+### Get Started Using InfluxDB 3
 
-*InfluxDB Enterprise v1 is an earlier version of InfluxDB Enterprise. InfluxDB 3 Enterprise is the latest stable version.*
+After starting your InfluxDB 3 server:
 
-Use the official `%%IMAGE%%:meta` and `%%IMAGE%%:data` Docker images to deploy and manage an InfluxDB v1 Enterprise cluster. A valid license is required.
+-	Follow the [Get started guide](https://docs.influxdata.com/influxdb3/core/get-started/) to create an auth token and database, and write, query, and process data.
+-	Use the [InfluxDB 3 Explorer UI](https://docs.influxdata.com/influxdb3/explorer/) to write data, create dashboards, explore metrics, and manage databases
 
-### Start InfluxDB v1 Enterprise Cluster
+### InfluxDB 3 Server Options
 
-Create a custom Docker network for node communication:
+Customize your deployment with available [server options](https://docs.influxdata.com/influxdb3/core/reference/clis/influxdb3/serve/):
 
 ```bash
-docker network create influxdb
+# View all available options
+docker run --rm %%IMAGE%%:3-core influxdb3 serve --help
 ```
 
-Start three meta nodes (each with a unique hostname and license key):
+## Using InfluxDB v2
 
-```bash
-# Meta node 0
-docker run -d \
-  --name=influxdb-meta-0 \
-  --network=influxdb \
-  -h influxdb-meta-0 \
-  -e INFLUXDB_ENTERPRISE_LICENSE_KEY=your-license-key \
-  %%IMAGE%%:meta
-
-# Meta node 1
-docker run -d \
-  --name=influxdb-meta-1 \
-  --network=influxdb \
-  -h influxdb-meta-1 \
-  -e INFLUXDB_ENTERPRISE_LICENSE_KEY=your-license-key \
-  %%IMAGE%%:meta
-
-# Meta node 2
-docker run -d \
-  --name=influxdb-meta-2 \
-  --network=influxdb \
-  -h influxdb-meta-2 \
-  -e INFLUXDB_ENTERPRISE_LICENSE_KEY=your-license-key \
-  %%IMAGE%%:meta
-```
+*InfluxDB v2 is a previous version. Consider InfluxDB 3 Core for new deployments.*
 
-Join meta nodes into the cluster:
+### Start InfluxDB v2
 
 ```bash
-docker exec influxdb-meta-0 influxd-ctl add-meta influxdb-meta-1:8091
-docker exec influxdb-meta-0 influxd-ctl add-meta influxdb-meta-2:8091
-```
-
-Start data nodes:
-
-```bash
-# Data node 0
-docker run -d \
-  --name=influxdb-data-0 \
-  --network=influxdb \
-  -h influxdb-data-0 \
-  -e INFLUXDB_ENTERPRISE_LICENSE_KEY=your-license-key \
-  %%IMAGE%%:data
-
-# Data node 1
-docker run -d \
-  --name=influxdb-data-1 \
-  --network=influxdb \
-  -h influxdb-data-1 \
-  -e INFLUXDB_ENTERPRISE_LICENSE_KEY=your-license-key \
-  %%IMAGE%%:data
-```
-
-Add data nodes to the cluster:
-
-```bash
-docker exec influxdb-meta-0 influxd-ctl add-data influxdb-data-0:8088
-docker exec influxdb-meta-0 influxd-ctl add-data influxdb-data-1:8088
+docker run -d -p 8086:8086 \
+  -v $PWD/data:/var/lib/influxdb2 \
+  -v $PWD/config:/etc/influxdb2 \
+  -e DOCKER_INFLUXDB_INIT_MODE=setup \
+  -e DOCKER_INFLUXDB_INIT_USERNAME=my-user \
+  -e DOCKER_INFLUXDB_INIT_PASSWORD=my-password \
+  -e DOCKER_INFLUXDB_INIT_ORG=my-org \
+  -e DOCKER_INFLUXDB_INIT_BUCKET=my-bucket \
+  %%IMAGE%%:2
 ```
 
-Verify cluster status:
-
-```bash
-docker exec influxdb-meta-0 influxd-ctl show
-```
+After the container starts, visit [http://localhost:8086](http://localhost:8086) to view the UI.
 
-This displays all registered data and meta nodes.
+For detailed instructions, see the [InfluxDB v2 Docker Compose documentation](https://docs.influxdata.com/influxdb/v2/install/use-docker-compose/).
 
-### Stop InfluxDB v1 Enterprise Containers
+## Using InfluxDB v1
 
-To stop individual containers:
+*InfluxDB v1 is a previous version. Consider InfluxDB 3 Core for new deployments.*
 
-```bash
-docker stop influxdb-meta-0
-docker stop influxdb-meta-1
-docker stop influxdb-meta-2
-docker stop influxdb-data-0
-docker stop influxdb-data-1
+```console
+docker run -d -p 8086:8086 \
+  -v $PWD:/var/lib/influxdb \
+  %%IMAGE%%:1.11
 ```
 
-### Restart Containers
-
-To restart stopped containers:
+This starts InfluxDB v1 with:
 
-```bash
-docker start influxdb-meta-0
-docker start influxdb-meta-1
-docker start influxdb-meta-2
-docker start influxdb-data-0
-docker start influxdb-data-1
-```
+-	HTTP API on port 8086
+-	Data persisted to current directory
 
-For more information, see the [InfluxDB v1 Enterprise documentation](https://docs.influxdata.com/enterprise_influxdb/v1/introduction/installation/docker/).
+For more information, see the [InfluxDB v1 Docker documentation](https://docs.influxdata.com/influxdb/v1/introduction/install/docker/).

influxdb/variant-data.md

@@ -1,7 +1,7 @@
-## `%%IMAGE%%:data`
+## `%%IMAGE%%:1-data`
 
 *Using this image for [InfluxDB Enterprise](https://docs.influxdata.com/enterprise_influxdb/v1/introduction/installation/meta_node_installation/#license-key-or-file) requires a valid InfluxData [license key](https://docs.influxdata.com/enterprise_influxdb/v1/introduction/installation/meta_node_installation/#license-key-or-file).*
 
 This image contains the enterprise data node package for clustering. It supports all of the same options as the InfluxDB 1.x OSS image, but it needs port 8088 to be exposed to the meta nodes.
 
-Refer to the `influxdb:meta` variant for directions on how to setup a cluster.
+Refer to the `influxdb:1-meta` variant for directions on how to setup a cluster.

influxdb/variant-meta.md

@@ -1,8 +1,8 @@
-## `%%IMAGE%%:meta`
+## `%%IMAGE%%:1-meta`
 
 *This image requires a valid license key from InfluxData.* Please visit our [products page](https://www.influxdata.com/products/) to learn more.
 
-This image contains the enterprise meta node package for clustering. It is meant to be used in conjunction with the `influxdb:data` package of the same version.
+This image contains the enterprise meta node package for clustering. It is meant to be used in conjunction with the `influxdb:1-data` package of the same version.
 
 ### Using this Image
 
@@ -13,7 +13,7 @@ The license key can be specified using either an environment variable or by over
 ```console
 docker run -p 8089:8089 -p 8091:8091 \
       -e INFLUXDB_ENTERPRISE_LICENSE_KEY=<license-key>
-      %%IMAGE%%:meta
+      %%IMAGE%%:1-meta
 ```
 
 #### Running the container
@@ -32,15 +32,15 @@ Start three meta nodes. This is the suggested number of meta nodes. We do not re
 docker run -d --name=influxdb-meta-0 --network=influxdb \
       -h influxdb-meta-0 \
       -e INFLUXDB_ENTERPRISE_LICENSE_KEY=<license-key> \
-      %%IMAGE%%:meta
+      %%IMAGE%%:1-meta
 docker run -d --name=influxdb-meta-1 --network=influxdb \
       -h influxdb-meta-1 \
       -e INFLUXDB_ENTERPRISE_LICENSE_KEY=<license-key> \
-      %%IMAGE%%:meta
+      %%IMAGE%%:1-meta
 docker run -d --name=influxdb-meta-2 --network=influxdb \
       -h influxdb-meta-2 \
       -e INFLUXDB_ENTERPRISE_LICENSE_KEY=<license-key> \
-      %%IMAGE%%:meta
+      %%IMAGE%%:1-meta
 ```
 
 When setting the hostname, you can use `-h <hostname>` or you can directly set the environment variable using `-e INFLUXDB_HOSTNAME=<hostname>`.
@@ -60,7 +60,7 @@ Or you can just start a single meta node. If you setup a single meta node, you d
 docker run -d --name=influxdb-meta --network=influxdb \
       -h influxdb-meta \
       -e INFLUXDB_ENTERPRISE_LICENSE_KEY=<license-key> \
-      %%IMAGE%%:meta -single-server
+      %%IMAGE%%:1-meta -single-server
 ```
 
 #### Connecting the data nodes
@@ -71,7 +71,7 @@ Start the data nodes using `%%IMAGE%%:data` with similar command line arguments
 docker run -d --name=influxdb-data-0 --network=influxdb \
       -h influxdb-data-0 \
       -e INFLUXDB_LICENSE_KEY=<license-key> \
-      %%IMAGE%%:data
+      %%IMAGE%%:1-data
 ```
 
 You can add `-p 8086:8086` to expose the http port to the host machine. After starting the container, choose one of the meta nodes and add the data node to it.
@@ -102,7 +102,7 @@ Modify the default configuration, which will now be available under `$PWD`. Then
 ```console
 docker run \
       -v $PWD/influxdb-meta.conf:/etc/influxdb/influxdb-meta.conf:ro \
-      %%IMAGE%% -config /etc/influxdb/influxdb-meta.conf
+      %%IMAGE%%:1-meta -config /etc/influxdb/influxdb-meta.conf
 ```
 
 Modify `$PWD` to the directory where you want to store the configuration file.