influxdata/influxdb3-ui

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. Explorer provides an intuitive interface for interacting with your time series data.

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 https://hub.docker.com/_/influxdb.

Pull the image

bash
docker pull influxdata/influxdb3-ui:1.9.0

Start InfluxDB 3 Explorer

Run InfluxDB 3 Explorer using Docker CLI.

Query mode (default)

To start Explorer in query mode for read-only access:

bash
docker run --detach \
  --name influxdb3-explorer \
  --publish 8080:8080 \
  influxdata/influxdb3-ui:1.9.0

Admin mode

To start Explorer in admin mode with full functionality:

bash
docker run --detach \
  --name influxdb3-explorer \
  --publish 8080:8080 \
  influxdata/influxdb3-ui:1.9.0 \
  --mode=admin

This command:

• Maps container port 8080 to host port 8080 (web UI)
• Runs the container in admin mode

If --mode is not set, the container defaults to query mode.

Access the Explorer UI at http://localhost:8080 in your browser.

Persistent data storage

To preserve Explorer application data across container restarts, mount a local directory:

IMPORTANT: The container runs as non-root user influxui (uid 1500). The mounted directory must be owned by this user.

bash
mkdir -p ./db
sudo chown -R 1500:1500 ./db
chmod 700 ./db

bash
docker run --detach \
  --name influxdb3-explorer \
  --publish 8080:8080 \
  --volume $(pwd)/db:/db:rw \
  influxdata/influxdb3-ui:1.9.0 \
  --mode=admin

Troubleshooting: If you see SQLITE_CANTOPEN errors, fix the directory ownership:

bash
sudo chown -R 1500:1500 ./db
docker restart influxdb3-explorer

Pre-configure InfluxDB connections

To pre-configure InfluxDB connection settings, create a config.json file and mount it:

bash
mkdir -p ./config ./db
sudo chown -R 1500:1500 ./db
chmod 755 ./config
chmod 700 ./db

# Create config file
cat > ./config/config.json << 'EOF'
{
  "DEFAULT_INFLUX_SERVER": "http://host.docker.internal:8181",
  "DEFAULT_INFLUX_DATABASE": "my_database",
  "DEFAULT_API_TOKEN": "your-admin-token",
  "DEFAULT_SERVER_NAME": "my_server"
}
EOF

bash
docker run --detach \
  --name influxdb3-explorer \
  --publish 8080:8080 \
  --volume $(pwd)/config:/app-root/config:ro \
  --volume $(pwd)/db:/db:rw \
  influxdata/influxdb3-ui:1.9.0 \
  --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: cert.pem or server.crt Private key: key.pem or server.key

bash
# Create directories
mkdir -p ./ssl ./db
sudo chown -R 1500:1500 ./db
chmod 755 ./ssl

# Place your cert.pem and key.pem files in ./ssl directory

docker run --detach \
  --name influxdb3-explorer \
  --publish 8080:8080 \
  --publish 8443:8443 \
  --volume $(pwd)/ssl:/etc/nginx/ssl:ro \
  --volume $(pwd)/db:/db:rw \
  --env SSL_CERT_PATH=/etc/nginx/ssl/cert.pem \
  --env SSL_KEY_PATH=/etc/nginx/ssl/key.pem \
  influxdata/influxdb3-ui:1.9.0 \
  --mode=admin

Access the UI via HTTPS at https://localhost:8443

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
mkdir -p ./ssl ./db
sudo chown -R 1500:1500 ./db
chmod 755 ./ssl

docker run --detach \
  --name influxdb3-explorer \
  --publish 8080:8080 \
  --publish 8443:8443 \
  --volume $(pwd)/ssl:/custom/ssl:ro \
  --volume $(pwd)/db:/db:rw \
  --env SSL_CERT_PATH=/custom/ssl/server.crt \
  --env SSL_KEY_PATH=/custom/ssl/server.key \
  influxdata/influxdb3-ui:1.9.0 \
  --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)

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 https://docs.influxdata.com/influxdb3/explorer/install/