Use the integrated InfluxDB 3 Explorer UI

Starting with InfluxDB 3 Enterprise v3.11, the InfluxDB 3 Explorer web UI ships inside the Enterprise binary as a WebAssembly (WASM) guest that the server hosts in-process behind a WASI sandbox. To serve Explorer from your server, add the webui mode when you start the server. You don’t need to run the Explorer Docker container alongside InfluxDB.

Explorer isn’t enabled by default. The all mode doesn’t include webui, so name webui explicitly–for example, --mode all,webui.

• Before you begin
• Check your version
• Start the server with Explorer enabled
• Connect Explorer to your server
• Manage the session secret
• Explorer application data
• Enable AI chat
• Choose between integrated and containerized Explorer

Before you begin

To serve Explorer from your server, you need the following:

• InfluxDB 3 Enterprise v3.11 or later. For earlier releases, run the Explorer Docker container.
• A session secret. InfluxDB 3 Enterprise requires --webui-session-secret whenever webui mode is enabled, and doesn’t start without it.
• A plugin directory. Pass the directory to --plugin-dir and create it before you start the server.

Check your version

Explorer availability depends on the InfluxDB 3 server version and edition, not on the Explorer version alone. Use either of the following checks.

To check the version of a local binary:

influxdb3 --version

To check the version and edition of a running server, send a GET request to the /ping endpoint:

curl --get "http://localhost:8181/ping" \
  --header "Authorization: Bearer AUTH_TOKEN"

The response headers include x-influxdb-version and x-influxdb-build. x-influxdb-build reports Core or Enterprise, so one request answers both the version question and the edition question. Use GET; a HEAD request returns 404.

Start the server with Explorer enabled

1. Create the plugin directory:

   mkdir -p ./plugins

2. Start the server with webui added to --mode and a session secret:

   influxdb3 serve \
     --cluster-id cluster0 \
     --node-id node0 \
     --mode all,webui \
     --plugin-dir ./plugins \
     --webui-session-secret "$(openssl rand -base64 24)"

openssl rand -base64 24 generates a new secret on every start, which signs users out after each restart. For anything beyond a local trial, generate the secret once and pass the same value on every start. See Manage the session secret.

Connect Explorer to your server

After the server starts, configure a connection to your server in Explorer the same way you configure one in the standalone Docker Explorer–for example, http://localhost:8181. For the connection fields and the steps to create a connection, see Get started with InfluxDB 3 Explorer.

Manage the session secret

--webui-session-secret signs the session cookies that Explorer issues. The server requires the option whenever webui mode is enabled.

• Generate the secret once and reuse it. A secret that changes on restart invalidates every existing session.
• Keep the secret out of your shell history and process list. Set the secret through the environment variable instead of the command line when you can.
• Rotate the secret when it may have been exposed. Rotating signs out all users.

To generate a secret:

openssl rand -base64 24

Explorer application data

The integrated Explorer keeps its application state in a SQLite database that the server synchronizes to object storage for each cluster. You don’t mount a volume to persist it, which is the main operational difference from the Explorer Docker container.

Enable AI chat

Explorer includes an AI chat feature that you can point at any OpenAI-compatible endpoint. To enable it, set --webui-openai-base-url to the base URL of the endpoint:

influxdb3 serve \
  --cluster-id cluster0 \
  --node-id node0 \
  --mode all,webui \
  --plugin-dir ./plugins \
  --webui-session-secret "$WEBUI_SESSION_SECRET" \
  --webui-openai-base-url "https://your-openai-compatible-endpoint"

Chat prompts, and any query results included with them, go to the endpoint you configure. Choose an endpoint that your data handling policies allow.

Choose between integrated and containerized Explorer

Use the container when you run Core, when you run an Enterprise release earlier than v3.11, or when you want Explorer to run separately from the database server–for example, on an operator workstation. See Install and run InfluxDB 3 Explorer.