From 71e1aaa9e9997111dc396d65de6681b9bd070d57 Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 10:30:06 -0700 Subject: [PATCH 01/23] Add initial influxdb3-explorer documentation structure --- influxdb3-explorer/README-short.txt | 0 influxdb3-explorer/content.md | 0 influxdb3-explorer/github-repo | 0 influxdb3-explorer/license.md | 0 influxdb3-explorer/maintainer.md | 0 influxdb3-explorer/metadata.json | 0 6 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 influxdb3-explorer/README-short.txt create mode 100644 influxdb3-explorer/content.md create mode 100644 influxdb3-explorer/github-repo create mode 100644 influxdb3-explorer/license.md create mode 100644 influxdb3-explorer/maintainer.md create mode 100644 influxdb3-explorer/metadata.json diff --git a/influxdb3-explorer/README-short.txt b/influxdb3-explorer/README-short.txt new file mode 100644 index 000000000000..e69de29bb2d1 diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md new file mode 100644 index 000000000000..e69de29bb2d1 diff --git a/influxdb3-explorer/github-repo b/influxdb3-explorer/github-repo new file mode 100644 index 000000000000..e69de29bb2d1 diff --git a/influxdb3-explorer/license.md b/influxdb3-explorer/license.md new file mode 100644 index 000000000000..e69de29bb2d1 diff --git a/influxdb3-explorer/maintainer.md b/influxdb3-explorer/maintainer.md new file mode 100644 index 000000000000..e69de29bb2d1 diff --git a/influxdb3-explorer/metadata.json b/influxdb3-explorer/metadata.json new file mode 100644 index 000000000000..e69de29bb2d1 From f087e25669ca3d9946361468a80fa047ee1d0e0e Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 10:38:35 -0700 Subject: [PATCH 02/23] docs: add GitHub repo URL to github-repo file --- influxdb3-explorer/github-repo | 1 + 1 file changed, 1 insertion(+) diff --git a/influxdb3-explorer/github-repo b/influxdb3-explorer/github-repo index e69de29bb2d1..e93b5078af15 100644 --- a/influxdb3-explorer/github-repo +++ b/influxdb3-explorer/github-repo @@ -0,0 +1 @@ +https://github.com/influxdata/influxdata-docker \ No newline at end of file From 1638f4961c1316ad990f3f482ced9ae3212e9037 Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 10:41:23 -0700 Subject: [PATCH 03/23] docs: add short description to README-short.txt --- influxdb3-explorer/README-short.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/influxdb3-explorer/README-short.txt b/influxdb3-explorer/README-short.txt index e69de29bb2d1..1739f33490fb 100644 --- a/influxdb3-explorer/README-short.txt +++ b/influxdb3-explorer/README-short.txt @@ -0,0 +1 @@ +InfluxDB 3 Explorer is a web-based interface for querying and visualizing InfluxDB 3 data. From 0e616f709cf34e24bf8d47365427ae4fea38655a Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 10:43:04 -0700 Subject: [PATCH 04/23] docs: Add short message for license.md --- influxdb3-explorer/license.md | 1 + 1 file changed, 1 insertion(+) diff --git a/influxdb3-explorer/license.md b/influxdb3-explorer/license.md index e69de29bb2d1..41cf31d09b90 100644 --- a/influxdb3-explorer/license.md +++ b/influxdb3-explorer/license.md @@ -0,0 +1 @@ +View [license information](http://golang.org/LICENSE) for the software contained in this image. \ No newline at end of file From aaee7d71335d45a857006bae0ed60b8fc775b950 Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 10:44:38 -0700 Subject: [PATCH 05/23] docs: Add short description for maintainer.md --- influxdb3-explorer/maintainer.md | 1 + 1 file changed, 1 insertion(+) diff --git a/influxdb3-explorer/maintainer.md b/influxdb3-explorer/maintainer.md index e69de29bb2d1..4bee6ceacd5b 100644 --- a/influxdb3-explorer/maintainer.md +++ b/influxdb3-explorer/maintainer.md @@ -0,0 +1 @@ +../.common-templates/maintainer-influxdata.md \ No newline at end of file From 7f3df53d67b2699f9114324e4c972a9e727bf07c Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 10:47:03 -0700 Subject: [PATCH 06/23] docs: Add metedata for explorer --- influxdb3-explorer/metadata.json | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/influxdb3-explorer/metadata.json b/influxdb3-explorer/metadata.json index e69de29bb2d1..4e24bc74b60c 100644 --- a/influxdb3-explorer/metadata.json +++ b/influxdb3-explorer/metadata.json @@ -0,0 +1,7 @@ +{ + "hub": { + "categories": [ + "monitoring-and-observability" + ] + } + } \ No newline at end of file From 8300e309b09e2b28f895e1c2561d9152dd77db16 Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 11:45:44 -0700 Subject: [PATCH 07/23] docs: add intro and quick start section to README --- influxdb3-explorer/content.md | 38 +++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index e69de29bb2d1..eef02742668c 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -0,0 +1,38 @@ +# What is InfluxDB 3 Explorer? + +InfluxDB 3 Explorer is a standalone web application designed for visualizing, querying, and managing your data stored in InfluxDB 3 Core and Enterprise. Explorer provides an intuitive interface for interacting with your time series data. + +%%LOGO%% + +## Quick start with InfluxDB 3 Explorer + +Follow these steps to start InfluxDB 3 Explorer using Docker: + +### Pull the Docker image + +```bash +# Pull the Docker image +docker pull influxdata/influxdb3-ui:1.0.0 +``` + +### Run the container + +Once you have the latest image run the following command to start the Docker container: + +```bash +# Run the Docker container +docker run --detach \ + --name influxdb3-explorer \ + --publish 8888:80 \ + --publish 8889:8888 \ + influxdata/influxdb3-ui:1.0.0 \ + --mode=admin +``` + +This command: +- Creates a detached container named influxdb3-explorer +- Maps port `80` in the container to port `8888` on your host (web UI) +- Maps port `8888` in the container to port `8889` on your host (API) +- Runs the container in admin mode + +After running this command, access the Explorer UI at `http://localhost:8888` in your browser. \ No newline at end of file From 91df8662a410f660e457bd4832783963d67607af Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 13:02:34 -0700 Subject: [PATCH 08/23] docs: updates to README content --- influxdb3-explorer/content.md | 143 ++++++++++++++++++++++++++++++---- 1 file changed, 128 insertions(+), 15 deletions(-) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index eef02742668c..e66e5406054b 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -4,35 +4,148 @@ InfluxDB 3 Explorer is a standalone web application designed for visualizing, qu %%LOGO%% -## Quick start with InfluxDB 3 Explorer +# How to use this image -Follow these steps to start InfluxDB 3 Explorer using Docker: +## Start InfluxDB 3 Explorer -### Pull the Docker image +Run InfluxDB 3 Explorer using Docker CLI. -```bash -# Pull the Docker image -docker pull influxdata/influxdb3-ui:1.0.0 -``` +### Query mode (default) -### Run the container +To start Explorer in query mode for read-only access: -Once you have the latest image run the following command to start the Docker container: + ```bash +docker run --detach \ + --name influxdb3-explorer \ + --publish 8888:80 \ + influxdb3-explorer + ``` + +### Admin mode + +To start Explorer in admin mode with full functionality: ```bash -# Run the Docker container docker run --detach \ --name influxdb3-explorer \ --publish 8888:80 \ --publish 8889:8888 \ - influxdata/influxdb3-ui:1.0.0 \ + influxdb3-explorer \ --mode=admin ``` This command: -- Creates a detached container named influxdb3-explorer -- Maps port `80` in the container to port `8888` on your host (web UI) -- Maps port `8888` in the container to port `8889` on your host (API) + +- Maps container port `80` to host port `8888` (web UI) +- Maps container port `8888` to host port `8889` (API access) - Runs the container in admin mode -After running this command, access the Explorer UI at `http://localhost:8888` in your browser. \ No newline at end of file +If `--mode` is not set, the container defaults to query mode. + +Access the Explorer UI at `http://localhost:8888` in your browser. + +## Persistent data storage + +To preserve Explorer application data across container restarts, mount a local directory: + +```bash +mkdir -m 700 ./db +``` + +```bash +docker run --detach \ + --name influxdb3-explorer \ + --publish 8888:80 \ + --volume $(pwd)/db:/db:rw \ + influxdb3-explorer \ + --mode=admin +``` + +## Pre-configure InfluxDB connections + +To pre-configure InfluxDB connection settings, create a `config.json` file and mount it: + +```bash +mkdir -m 755 ./config + +{ + "DEFAULT_INFLUX_SERVER": "http://host.docker.internal:8181", + "DEFAULT_INFLUX_DATABASE": "my_database", + "DEFAULT_API_TOKEN": "your-admin-token", + "DEFAULT_SERVER_NAME": "my_server" +} +``` + +```bash +docker run --detach \ + --name influxdb3-explorer \ + --publish 8888:80 \ + --volume $(pwd)/config:/app-root/config:ro \ + --volume $(pwd)/db:/db:rw \ + influxdb3-explorer \ + --mode=admin +``` + +## Enable HTTPS + +To enable TLS/SSL, mount valid certificate and key files into the container: + +Place your TLS/SSL certificate files in your local `./ssl` directory: +Required files: + +Certificate: `server.crt` or `fullchain.pem` +Private key: `server.key` + +```bash +mkdir -m 755 ./ssl + +# Place your server.crt and server.key files in ./ssl directory + +docker run --detach \ + --name influxdb3-explorer \ + --publish 8888:443 \ + --volume $(pwd)/ssl:/etc/nginx/ssl:ro \ + influxdb3-explorer \ + --mode=admin +``` + +The nginx web server automatically uses certificate files when they are present in the mounted path. + +## Custom SSL certificate paths + +You can use custom locations for certificate and key files: + +```bash +docker run --detach \ + --name influxdb3-explorer \ + --publish 8888:443 \ + --volume $(pwd)/ssl:/custom/ssl:ro \ + --env SSL_CERT_PATH=/custom/ssl/server.crt \ + --env SSL_KEY_PATH=/custom/ssl/server.key \ + influxdb3-explorer \ + --mode=admin +``` + +## Environment variables + +The following environment variables can be used to configure the container: + +- `DATABASE_URL` - Path to SQLite database inside container (default: `/db/sqlite.db`) +- `SESSION_SECRET_KEY` - Secret key for session management (recommended for production) +- `SSL_CERT_PATH` - Path to SSL certificate file (default: `/etc/nginx/ssl/cert.pem`) +- `SSL_KEY_PATH` - Path to SSL private key file (default: `/etc/nginx/ssl/key.pem`) + +Example with environment variables: + +```bash +docker run --detach \ + --name influxdb3-explorer \ + --publish 8888:80 \ + --env SESSION_SECRET_KEY=xxX0Xx000xX0XxxxX0Xx000xX0XxX00x \ + --env DATABASE_URL=/db/sqlite.db \ + --volume $(pwd)/db:/db:rw \ + influxdb3-explorer \ + --mode=admin +``` + +Important for production: Always set `SESSION_SECRET_KEY` in production. When you restart the container, InfluxDB 3 Explorer generates a new key if not explicitly set. \ No newline at end of file From 7338a5a5b9d51ad14ab651b1b16c69facf766d6f Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 17:07:00 -0700 Subject: [PATCH 09/23] docs: update to metedata.md --- influxdb3-explorer/README-short.txt | 2 +- influxdb3-explorer/metadata.json | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/influxdb3-explorer/README-short.txt b/influxdb3-explorer/README-short.txt index 1739f33490fb..62d9c83927dd 100644 --- a/influxdb3-explorer/README-short.txt +++ b/influxdb3-explorer/README-short.txt @@ -1 +1 @@ -InfluxDB 3 Explorer is a web-based interface for querying and visualizing InfluxDB 3 data. +InfluxDB 3 Explorer is a web-based interface for querying and visualizing InfluxDB 3 data. \ No newline at end of file diff --git a/influxdb3-explorer/metadata.json b/influxdb3-explorer/metadata.json index 4e24bc74b60c..8b5bb1909ecd 100644 --- a/influxdb3-explorer/metadata.json +++ b/influxdb3-explorer/metadata.json @@ -1,7 +1,9 @@ { "hub": { "categories": [ - "monitoring-and-observability" + "data-science", + "databases-and-storage", + "internet-of-things" ] } } \ No newline at end of file From 553983031910e8f46ecfb8151c3d050bf536216f Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 17:11:56 -0700 Subject: [PATCH 10/23] small update to github-repo.md --- influxdb3-explorer/github-repo | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/influxdb3-explorer/github-repo b/influxdb3-explorer/github-repo index e93b5078af15..8253c181ea5b 100644 --- a/influxdb3-explorer/github-repo +++ b/influxdb3-explorer/github-repo @@ -1 +1 @@ -https://github.com/influxdata/influxdata-docker \ No newline at end of file +https://github.com/influxdata/influxdata-docker From 5f5637e3ec81f1efb1a48d419e413c89513f6eda Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 17:12:49 -0700 Subject: [PATCH 11/23] small update to metadata.md --- influxdb3-explorer/metadata.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/influxdb3-explorer/metadata.json b/influxdb3-explorer/metadata.json index 8b5bb1909ecd..94165d2075d9 100644 --- a/influxdb3-explorer/metadata.json +++ b/influxdb3-explorer/metadata.json @@ -6,4 +6,5 @@ "internet-of-things" ] } - } \ No newline at end of file + } + \ No newline at end of file From 2b9af04ee3c4fc89c3bdb4241ea04c92f4831d4a Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 17:40:30 -0700 Subject: [PATCH 12/23] docs: minor update to files to fix CI issue --- influxdb3-explorer/content.md | 26 ++++++++++++-------------- influxdb3-explorer/license.md | 2 +- influxdb3-explorer/maintainer.md | 2 +- 3 files changed, 14 insertions(+), 16 deletions(-) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index e66e5406054b..a8084291d599 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -14,12 +14,12 @@ Run InfluxDB 3 Explorer using Docker CLI. To start Explorer in query mode for read-only access: - ```bash +```bash docker run --detach \ --name influxdb3-explorer \ --publish 8888:80 \ influxdb3-explorer - ``` +``` ### Admin mode @@ -36,9 +36,9 @@ docker run --detach \ This command: -- Maps container port `80` to host port `8888` (web UI) -- Maps container port `8888` to host port `8889` (API access) -- Runs the container in admin mode +- Maps container port `80` to host port `8888` (web UI) +- Maps container port `8888` to host port `8889` (API access) +- Runs the container in admin mode If `--mode` is not set, the container defaults to query mode. @@ -90,11 +90,9 @@ docker run --detach \ To enable TLS/SSL, mount valid certificate and key files into the container: -Place your TLS/SSL certificate files in your local `./ssl` directory: -Required files: +Place your TLS/SSL certificate files in your local `./ssl` directory: Required files: -Certificate: `server.crt` or `fullchain.pem` -Private key: `server.key` +Certificate: `server.crt` or `fullchain.pem` Private key: `server.key` ```bash mkdir -m 755 ./ssl @@ -130,10 +128,10 @@ docker run --detach \ The following environment variables can be used to configure the container: -- `DATABASE_URL` - Path to SQLite database inside container (default: `/db/sqlite.db`) -- `SESSION_SECRET_KEY` - Secret key for session management (recommended for production) -- `SSL_CERT_PATH` - Path to SSL certificate file (default: `/etc/nginx/ssl/cert.pem`) -- `SSL_KEY_PATH` - Path to SSL private key file (default: `/etc/nginx/ssl/key.pem`) +- `DATABASE_URL` - Path to SQLite database inside container (default: `/db/sqlite.db`) +- `SESSION_SECRET_KEY` - Secret key for session management (recommended for production) +- `SSL_CERT_PATH` - Path to SSL certificate file (default: `/etc/nginx/ssl/cert.pem`) +- `SSL_KEY_PATH` - Path to SSL private key file (default: `/etc/nginx/ssl/key.pem`) Example with environment variables: @@ -148,4 +146,4 @@ docker run --detach \ --mode=admin ``` -Important for production: Always set `SESSION_SECRET_KEY` in production. When you restart the container, InfluxDB 3 Explorer generates a new key if not explicitly set. \ No newline at end of file +Important for production: Always set `SESSION_SECRET_KEY` in production. When you restart the container, InfluxDB 3 Explorer generates a new key if not explicitly set. diff --git a/influxdb3-explorer/license.md b/influxdb3-explorer/license.md index 41cf31d09b90..00207f378fed 100644 --- a/influxdb3-explorer/license.md +++ b/influxdb3-explorer/license.md @@ -1 +1 @@ -View [license information](http://golang.org/LICENSE) for the software contained in this image. \ No newline at end of file +View [license information](http://golang.org/LICENSE) for the software contained in this image. diff --git a/influxdb3-explorer/maintainer.md b/influxdb3-explorer/maintainer.md index 4bee6ceacd5b..9a61d6230a28 100644 --- a/influxdb3-explorer/maintainer.md +++ b/influxdb3-explorer/maintainer.md @@ -1 +1 @@ -../.common-templates/maintainer-influxdata.md \ No newline at end of file +../.common-templates/maintainer-influxdata.md From 5ea2c83552b8475bc936bae95966acd1156f51cd Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 17:46:08 -0700 Subject: [PATCH 13/23] minor update to metadata.json format --- influxdb3-explorer/metadata.json | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/influxdb3-explorer/metadata.json b/influxdb3-explorer/metadata.json index 94165d2075d9..4c4fc816dd36 100644 --- a/influxdb3-explorer/metadata.json +++ b/influxdb3-explorer/metadata.json @@ -1,10 +1,10 @@ { - "hub": { - "categories": [ - "data-science", - "databases-and-storage", - "internet-of-things" - ] - } - } + "hub": { + "categories": [ + "data-science", + "databases-and-storage", + "internet-of-things" + ] + } +} \ No newline at end of file From 34586940db630e8b3116ce8a3fa06646859570fb Mon Sep 17 00:00:00 2001 From: meelahme Date: Tue, 15 Jul 2025 20:16:48 -0700 Subject: [PATCH 14/23] Adding a logo file --- influxdb3-explorer/logo.png | Bin 0 -> 8599 bytes influxdb3-explorer/metadata.json | 17 +++++++++-------- 2 files changed, 9 insertions(+), 8 deletions(-) create mode 100644 influxdb3-explorer/logo.png diff --git a/influxdb3-explorer/logo.png b/influxdb3-explorer/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..814b2d78b59678c586d53bca63c727b7cfe7d007 GIT binary patch literal 8599 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 Date: Tue, 15 Jul 2025 20:20:58 -0700 Subject: [PATCH 15/23] small update to metadata.json --- influxdb3-explorer/metadata.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/influxdb3-explorer/metadata.json b/influxdb3-explorer/metadata.json index cc689937568b..ac1685bc2c70 100644 --- a/influxdb3-explorer/metadata.json +++ b/influxdb3-explorer/metadata.json @@ -8,4 +8,4 @@ } } - \ No newline at end of file + \ No newline at end of file From a1ccbc0decd50a39fb380a7eb7182df3bf2579c6 Mon Sep 17 00:00:00 2001 From: meelahme Date: Thu, 17 Jul 2025 10:16:35 -0700 Subject: [PATCH 16/23] minor update to metadata.json --- influxdb3-explorer/metadata.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/influxdb3-explorer/metadata.json b/influxdb3-explorer/metadata.json index ac1685bc2c70..5b0680658296 100644 --- a/influxdb3-explorer/metadata.json +++ b/influxdb3-explorer/metadata.json @@ -7,5 +7,4 @@ ] } } - - \ No newline at end of file + \ No newline at end of file From f92fc31fdecf7230aa60a8e0fd9d3e5fae52acc4 Mon Sep 17 00:00:00 2001 From: meelahme Date: Thu, 17 Jul 2025 10:20:20 -0700 Subject: [PATCH 17/23] minor update to metadata.json --- influxdb3-explorer/metadata.json | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/influxdb3-explorer/metadata.json b/influxdb3-explorer/metadata.json index 5b0680658296..56ca576ac81a 100644 --- a/influxdb3-explorer/metadata.json +++ b/influxdb3-explorer/metadata.json @@ -1,10 +1,9 @@ { - "hub": { - "categories": [ - "data-science", - "databases-and-storage", - "internet-of-things" - ] - } + "hub": { + "categories": [ + "data-science", + "databases-and-storage", + "internet-of-things" + ] } - \ No newline at end of file +} From 077882f52913380e6715706166fb2ad7cbce4003 Mon Sep 17 00:00:00 2001 From: Jameelah Mercer <36314199+MeelahMe@users.noreply.github.com> Date: Thu, 17 Jul 2025 12:20:59 -0700 Subject: [PATCH 18/23] Update influxdb3-explorer/content.md Co-authored-by: Jason Stirnaman --- influxdb3-explorer/content.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index a8084291d599..fbdd2f015766 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -1,6 +1,6 @@ # What is InfluxDB 3 Explorer? -InfluxDB 3 Explorer is a standalone web application designed for visualizing, querying, and managing your data stored in InfluxDB 3 Core and Enterprise. Explorer provides an intuitive interface for interacting with your time series data. +InfluxDB 3 Explorer is a standalone web application designed for visualizing, querying, and managing your data stored in InfluxDB 3. Explorer provides an intuitive interface for interacting with your time series data. %%LOGO%% From 6504b06e6a116fbdb7966e042ead5965ccf47d47 Mon Sep 17 00:00:00 2001 From: Jameelah Mercer <36314199+MeelahMe@users.noreply.github.com> Date: Thu, 17 Jul 2025 12:21:13 -0700 Subject: [PATCH 19/23] Update influxdb3-explorer/content.md Co-authored-by: Jason Stirnaman --- influxdb3-explorer/content.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index fbdd2f015766..c94996d8aa22 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -6,6 +6,10 @@ InfluxDB 3 Explorer is a standalone web application designed for visualizing, qu # How to use this image +## Requirements + +To use InfluxDB 3 Explorer, you need a compatible InfluxDB 3 instance, such as InfluxDB 3 Core or InfluxDB 3 Enterprise. See the official [InfluxDB Docker image](https://hub.docker.com/_/influxdb). + ## Start InfluxDB 3 Explorer Run InfluxDB 3 Explorer using Docker CLI. From 6e9a72484e4fe09be8dfa0ae83c63dc87f691152 Mon Sep 17 00:00:00 2001 From: Jameelah Mercer <36314199+MeelahMe@users.noreply.github.com> Date: Thu, 17 Jul 2025 12:21:28 -0700 Subject: [PATCH 20/23] Update influxdb3-explorer/content.md Co-authored-by: Jason Stirnaman --- influxdb3-explorer/content.md | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index c94996d8aa22..cf600882ce3f 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -137,17 +137,4 @@ The following environment variables can be used to configure the container: - `SSL_CERT_PATH` - Path to SSL certificate file (default: `/etc/nginx/ssl/cert.pem`) - `SSL_KEY_PATH` - Path to SSL private key file (default: `/etc/nginx/ssl/key.pem`) -Example with environment variables: - -```bash -docker run --detach \ - --name influxdb3-explorer \ - --publish 8888:80 \ - --env SESSION_SECRET_KEY=xxX0Xx000xX0XxxxX0Xx000xX0XxX00x \ - --env DATABASE_URL=/db/sqlite.db \ - --volume $(pwd)/db:/db:rw \ - influxdb3-explorer \ - --mode=admin -``` - Important for production: Always set `SESSION_SECRET_KEY` in production. When you restart the container, InfluxDB 3 Explorer generates a new key if not explicitly set. From 69905be191b7f1e9924a5f904d70574b63fcbcb1 Mon Sep 17 00:00:00 2001 From: Jameelah Mercer <36314199+MeelahMe@users.noreply.github.com> Date: Thu, 17 Jul 2025 12:21:36 -0700 Subject: [PATCH 21/23] Update influxdb3-explorer/content.md Co-authored-by: Jason Stirnaman --- influxdb3-explorer/content.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index cf600882ce3f..f77614209067 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -137,4 +137,7 @@ The following environment variables can be used to configure the container: - `SSL_CERT_PATH` - Path to SSL certificate file (default: `/etc/nginx/ssl/cert.pem`) - `SSL_KEY_PATH` - Path to SSL private key file (default: `/etc/nginx/ssl/key.pem`) -Important for production: Always set `SESSION_SECRET_KEY` in production. When you restart the container, InfluxDB 3 Explorer generates a new key if not explicitly set. +**Important for production:** Always set `SESSION_SECRET_KEY` in production. When you restart the container, InfluxDB 3 Explorer generates a new key if not explicitly set. + +For more information about available options and environment variables, see the [InfluxDB 3 Explorer documentation](https://docs.influxdata.com/influxdb3/explorer/install/) + From 1e7187419113b155dbbfd9cda518845cdfa00e49 Mon Sep 17 00:00:00 2001 From: meelahme Date: Thu, 17 Jul 2025 12:26:03 -0700 Subject: [PATCH 22/23] CI: removing extra newline for CI --- influxdb3-explorer/content.md | 1 - 1 file changed, 1 deletion(-) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index f77614209067..56de3c104a14 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -140,4 +140,3 @@ The following environment variables can be used to configure the container: **Important for production:** Always set `SESSION_SECRET_KEY` in production. When you restart the container, InfluxDB 3 Explorer generates a new key if not explicitly set. For more information about available options and environment variables, see the [InfluxDB 3 Explorer documentation](https://docs.influxdata.com/influxdb3/explorer/install/) - From 6d6a9fc0cb74ed217b2dd7f9172a09e8a3821331 Mon Sep 17 00:00:00 2001 From: Jameelah Mercer <36314199+MeelahMe@users.noreply.github.com> Date: Thu, 17 Jul 2025 15:24:54 -0700 Subject: [PATCH 23/23] docs: Clarifying docker pull and image name in examples --- influxdb3-explorer/content.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/influxdb3-explorer/content.md b/influxdb3-explorer/content.md index 56de3c104a14..5367f7c8c02f 100644 --- a/influxdb3-explorer/content.md +++ b/influxdb3-explorer/content.md @@ -10,6 +10,12 @@ InfluxDB 3 Explorer is a standalone web application designed for visualizing, qu To use InfluxDB 3 Explorer, you need a compatible InfluxDB 3 instance, such as InfluxDB 3 Core or InfluxDB 3 Enterprise. See the official [InfluxDB Docker image](https://hub.docker.com/_/influxdb). +## Pull the image + +```bash +docker pull influxdata/influxdb3-ui:1.0.0 +``` + ## Start InfluxDB 3 Explorer Run InfluxDB 3 Explorer using Docker CLI. @@ -22,7 +28,7 @@ To start Explorer in query mode for read-only access: docker run --detach \ --name influxdb3-explorer \ --publish 8888:80 \ - influxdb3-explorer + influxdata/influxdb3-ui:1.0.0 ``` ### Admin mode @@ -34,7 +40,7 @@ docker run --detach \ --name influxdb3-explorer \ --publish 8888:80 \ --publish 8889:8888 \ - influxdb3-explorer \ + influxdata/influxdb3-ui:1.0.0 \ --mode=admin ``` @@ -61,7 +67,7 @@ docker run --detach \ --name influxdb3-explorer \ --publish 8888:80 \ --volume $(pwd)/db:/db:rw \ - influxdb3-explorer \ + influxdata/influxdb3-ui:1.0.0 \ --mode=admin ``` @@ -86,7 +92,7 @@ docker run --detach \ --publish 8888:80 \ --volume $(pwd)/config:/app-root/config:ro \ --volume $(pwd)/db:/db:rw \ - influxdb3-explorer \ + influxdata/influxdb3-ui:1.0.0 \ --mode=admin ``` @@ -107,7 +113,7 @@ docker run --detach \ --name influxdb3-explorer \ --publish 8888:443 \ --volume $(pwd)/ssl:/etc/nginx/ssl:ro \ - influxdb3-explorer \ + influxdata/influxdb3-ui:1.0.0 \ --mode=admin ``` @@ -124,7 +130,7 @@ docker run --detach \ --volume $(pwd)/ssl:/custom/ssl:ro \ --env SSL_CERT_PATH=/custom/ssl/server.crt \ --env SSL_KEY_PATH=/custom/ssl/server.key \ - influxdb3-explorer \ + influxdata/influxdb3-ui:1.0.0 \ --mode=admin ```