Skip to content

Commit 5f7fe5f

Browse files
committed
Rewrote install section to improve flow and clarify when to use CLI vs Docker
1 parent 66b39d3 commit 5f7fe5f

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

content/shared/v3-core-plugins/_index.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -522,7 +522,8 @@ influxdb3 create trigger \
522522

523523
### Install Python dependencies
524524

525-
Use the Processing Engine’s embedded Python environment to install any required third-party packages (for example, `pandas`, `requests`, or `numpy`).
525+
Use the `influxdb3 install package` command to add third-party libraries (like `pandas`, `requests`, or `influxdb3-python`) to your plugin environment.
526+
This installs packages into the Processing Engine’s embedded Python environment to ensure compatibility with your InfluxDB instance.
526527

527528
{{% code-placeholders "CONTAINER_NAME|PACKAGE_NAME" %}}
528529

@@ -554,10 +555,17 @@ docker exec -it CONTAINER_NAME influxdb3 install package pandas
554555

555556
{{< /code-tabs-wrapper >}}
556557

558+
These examples install the specified Python package (for example, pandas) into the Processing Engine’s embedded virtual environment.
559+
560+
- Use the CLI command when running InfluxDB directly on your system.
561+
- Use the Docker variant if you're running InfluxDB in a containerized environment.
562+
557563
> [!Note]
558-
> Don’t use `python -m venv` or your system Python to install packages for Processing Engine plugins.
559-
> The Processing Engine includes its own embedded Python environment. Always use the `influxdb3 install package`
560-
> command to ensure packages are installed in the correct environment.
564+
> If you create a custom virtual environment, use the Python interpreter bundled with InfluxDB 3—not system Python.
565+
> Creating a virtual environment with system Python (for example, using `python -m venv`) can lead to runtime errors and plugin failures.
566+
>
567+
>F or details, see the [Process Engine README](https://github.com/influxdata/influxdb/blob/main/README_processing_engine.md#official-builds)
568+
> for advanced setup instructions.
561569
562570
{{% /code-placeholders %}}
563571

0 commit comments

Comments
 (0)