--- title: influxdb3 install package description: The influxdb3 install package command installs Python packages for use in InfluxDB 3 processing engine plugins. url: https://docs.influxdata.com/influxdb3/core/reference/cli/influxdb3/install/package/ estimated_tokens: 2103 product: InfluxDB 3 Core version: core publisher: InfluxData canonical: https://docs.influxdata.com/influxdb3/core/reference/cli/influxdb3/install/package/ date: '2026-07-11T10:53:18+00:00' lastmod: '2026-07-11T10:53:18+00:00' --- The `influxdb3 install package` command installs Python packages within the plugin environment for use in [InfluxDB 3 Core processing engine plugins](/influxdb3/core/process/). Use this command to add external dependencies that your plugins require, such as data processing libraries, notification tools, or forecasting packages. ## Usage ```bash # Syntax influxdb3 install package [OPTIONS] [PACKAGES]... ``` ## Arguments * **`[PACKAGES]...`**: One or more package names to install (space-separated) ## Options | Option | Description | Default | Environment Variable | |-----------------------------------------------|-------------------------------------------------------------------------------------------------------------|-----------------------|---------------------------| | `-H`, `--host ` | The host URL of the running InfluxDB 3 Core server |`http://127.0.0.1:8181`| `INFLUXDB3_HOST_URL` | | `--token ` | The token for authentication with the InfluxDB 3 Core server | | `INFLUXDB3_AUTH_TOKEN` | | `--plugin-dir ` | Location of the plugins directory | `/plugins` | `INFLUXDB3_PLUGIN_DIR` | |`--virtual-env-location `| Custom virtual environment location | | `VIRTUAL_ENV` | | `--package-manager ` | Package manager to use: `discover`, `pip`, `uv`, or `disabled` | `discover` |`INFLUXDB3_PACKAGE_MANAGER`| | `--plugin-repo ` | Plugin repository URL | | `INFLUXDB3_PLUGIN_REPO` | | `-r`, `--requirements ` | Path to a `requirements.txt` file | | | | `--tls-ca ` | Path to a custom TLS certificate authority (for self-signed or internal certificates) | | `INFLUXDB3_TLS_CA` | | `--tls-no-verify` |Disable TLS certificate verification (**Not recommended in production**, useful for self-signed certificates)| | `INFLUXDB3_TLS_NO_VERIFY` | | `-h`, `--help` | Print help information | | | | `--help-all` | Print detailed help information | | | ## Examples ### Install a single package ```bash influxdb3 install package pandas ``` ### Install multiple packages ```bash influxdb3 install package pint pandas requests ``` ### Install packages from a requirements file ```bash influxdb3 install package -r requirements.txt ``` ### Install packages with custom host and authentication ```bash influxdb3 install package \ --host http://localhost:8181 \ --token AUTH_TOKEN \ pint pandas ``` Replace `AUTH_TOKEN` with your [admin token](/influxdb3/core/admin/tokens/)for your InfluxDB 3 Core instance. ### Install packages with a specific package manager ```bash influxdb3 install package \ --package-manager uv \ prophet adtk ``` ### Install packages with a custom CA certificate ```bash influxdb3 install package \ --tls-ca /path/to/ca-cert.pem \ requests ``` ## Package management ### Package manager selection By default (`--package-manager discover`), the CLI automatically detects and uses the best available package manager: 1. **uv** (preferred): Faster package installation 2. **pip** (fallback): Standard Python package manager ### Virtual environment The CLI manages a virtual environment for plugin packages to avoid conflicts with system Python packages. You can customize the virtual environment location with `--virtual-env-location` or the `VIRTUAL_ENV` environment variable. ### Security mode If your InfluxDB 3 Core server was started with [`--package-manager disabled`](/influxdb3/core/reference/config-options/#package-manager), the `influxdb3 install package` command is blocked for security and compliance requirements. When attempting to install packages with this command while the server has package installation disabled, the command fails with a `403 Forbidden` error: ``` Package installation has been disabled. Contact your administrator for more information. ``` The server’s `--package-manager disabled` setting is designed for: * **Enterprise security requirements**: Prevent arbitrary package installation * **Compliance environments**: Control exactly which packages are available * **Air-gapped deployments**: Pre-install all dependencies before deployment * **Multi-tenant scenarios**: Prevent tenants from installing potentially malicious packages In these environments, administrators must pre-install all required Python packages into the server’s virtual environment before starting InfluxDB 3 Core. For more information, see the [`package-manager`](/influxdb3/core/reference/config-options/#package-manager) configuration option. ### Troubleshooting If package installation fails: * **Check if package installation is disabled**: If you receive a `403 Forbidden` error, contact your administrator. Package installation may be disabled on your InfluxDB 3 Core instance. * **Verify network connectivity**: Ensure your InfluxDB 3 Core instance can reach PyPI or your custom package repository * **Check package names**: Verify package names are correct and available in the package repository * **Review logs**: Check InfluxDB 3 Core server logs for detailed error messages * **Test with pip**: Try installing the package directly with `pip` to verify it’s available * **Use requirements file**: For complex dependencies, use a `requirements.txt` file with version pinning * **Check Docker disk space** (Docker environments only): If running InfluxDB 3 Core in Docker and seeing “No space left on device” errors, free up disk space: ``` # Check Docker disk usage docker system df # Remove unused images and build cache docker image prune -af docker buildx prune -af ``` #### Related * [Processing engine and Python plugins](/influxdb3/core/plugins/) [cli](/influxdb3/core/tags/cli/)[processing engine](/influxdb3/core/tags/processing-engine/)[plugins](/influxdb3/core/tags/plugins/) | Option | Description | Default | Environment Variable | | --- | --- | --- | --- | | Option | Description | Default | Environment Variable | | -H , --host | The host URL of the running InfluxDB 3 Core server | http://127.0.0.1:8181 | INFLUXDB3_HOST_URL | | --token | The token for authentication with the InfluxDB 3 Core server | | INFLUXDB3_AUTH_TOKEN | | --plugin-dir | Location of the plugins directory | /plugins | INFLUXDB3_PLUGIN_DIR | | --virtual-env-location | Custom virtual environment location | | VIRTUAL_ENV | | --package-manager | Package manager to use: discover , pip , uv , or disabled | discover | INFLUXDB3_PACKAGE_MANAGER | | --plugin-repo | Plugin repository URL | | INFLUXDB3_PLUGIN_REPO | | -r , --requirements | Path to a requirements.txt file | | | | --tls-ca | Path to a custom TLS certificate authority (for self-signed or internal certificates) | | INFLUXDB3_TLS_CA | | --tls-no-verify | Disable TLS certificate verification ( Not recommended in production , useful for self-signed certificates) | | INFLUXDB3_TLS_NO_VERIFY | | -h , --help | Print help information | | | | --help-all | Print detailed help information | | |