influxdb3 install package

The influxdb3 install package command installs Python packages within the plugin environment for use in InfluxDB 3 Enterprise processing engine plugins. Use this command to add external dependencies that your plugins require, such as data processing libraries, notification tools, or forecasting packages.

Usage

# Syntax
influxdb3 install package [OPTIONS] [PACKAGES]...

Arguments

• [PACKAGES]...: One or more package names to install (space-separated)

Options

Examples

Install a single package

influxdb3 install package pandas

Install multiple packages

influxdb3 install package pint pandas requests

Install packages from a requirements file

influxdb3 install package -r requirements.txt

Install packages with custom host and authentication

influxdb3 install package \
  --host http://localhost:8181 \
  --token 
AUTH_TOKEN
 \
  pint pandas

Replace AUTH_TOKEN with your admin token for your InfluxDB 3 Enterprise instance.

Install packages with a specific package manager

influxdb3 install package \
  --package-manager uv \
  prophet adtk

Install packages with a custom CA certificate

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 Enterprise server was started with --package-manager disabled, 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 Enterprise.

For more information, see the 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 Enterprise instance.

• Verify network connectivity: Ensure your InfluxDB 3 Enterprise 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 Enterprise 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 Enterprise 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