{"record":{"id":"ad68d822e5eba6f3","repo":"influxdata/influxdb","slug":"python-plugins-not-enabled-on-this-server","errorCode":null,"errorMessage":"Python plugins not enabled on this server","messagePattern":"Python plugins not enabled on this server","errorType":"http","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"influxdb3_server/src/http.rs","lineNumber":355,"sourceCode":"\n    #[error(\n        \"provided a database in both the parameters ({param_db}) and \\\n        query string ({query_db}) that do not match, if providing a query \\\n        that specifies the database, you can omit the 'database' parameter \\\n        from your request\"\n    )]\n    InfluxqlDatabaseMismatch { param_db: String, query_db: String },\n\n    #[error(\"Operation with object store failed: {0}\")]\n    ObjectStore(#[from] object_store::Error),\n\n    #[error(\"heap dump failed: {0}\")]\n    HeapPprof(#[from] jemalloc_pprof_http::Error),\n\n    #[error(transparent)]\n    Catalog(#[from] CatalogError),\n\n    #[error(\"Python plugins not enabled on this server\")]\n    PythonPluginsNotEnabled,\n\n    #[error(\"Plugin error: {0}\")]\n    Plugin(#[from] influxdb3_processing_engine::plugins::PluginError),\n\n    #[error(\"Processing engine error: {0}\")]\n    ProcessingEngine(#[from] influxdb3_processing_engine::manager::ProcessingEngineError),\n\n    #[error(transparent)]\n    Influxdb3TypesHttp(#[from] influxdb3_types::http::Error),\n\n    #[error(\"Authorization error: {0}\")]\n    ResourceAuthorization(#[from] ResourceAuthorizationError),\n\n    #[error(\"Authentication error: {0}\")]\n    Authentication(#[from] AuthenticatorError),\n\n    #[error(\"The following Database does not exist: {0}\")]","sourceCodeStart":337,"sourceCodeEnd":373,"githubUrl":"https://github.com/influxdata/influxdb/blob/06200ef96ba82c5f6727e5038a83af8e722c6875/influxdb3_server/src/http.rs#L337-L373","documentation":"InfluxDB 3's HTTP server returns this error when a request targets the Python plugin / processing-engine endpoints but the server binary was built or started without Python plugin support. It is the `PythonPluginsNotEnabled` variant of `influxdb3_server::http::Error`. The feature is gated at startup (typically a compile feature or launch flag), so any plugin-related API call fails fast with this message instead of reaching the plugin runtime.","triggerScenarios":"Calling POST /api/v3/configure/processing_engine_trigger (or write-triggered plugin execution endpoints) against a server started without Python plugin support (e.g. the Docker image or binary compiled without the `python` feature, or `--plugin-dir` / Python support not enabled).","commonSituations":"Using a slim Docker image or OS package built without Python; upgrading a server and forgetting to enable the processing-engine flag; writing client code against a cluster where only some nodes have Python enabled; running tests with a feature-stripped binary.","solutions":["Restart the server with Python plugins enabled: use an image/binary built with the `python` feature and pass `--plugin-dir` (or the equivalent startup flag).","Verify with `influxdb3 --help` / server startup logs that the processing engine is available in your build.","If the request was sent by mistake, remove or redirect the plugin configuration/trigger calls to a node that supports Python plugins.","Pin your client/deployment so plugin endpoints are only called against Python-enabled instances."],"exampleFix":"// before: server started as\n// ./influxdb3 serve ...\n// after\n// ./influxdb3 serve --plugin-dir /var/lib/influxdb3/plugins ...  (Python-enabled build)","handlingStrategy":"validation","validationCode":"// Check server capabilities before calling plugin endpoints\nconst health = await fetch(`${base}/health`).then(r => r.json());\nif (!health.plugins?.python_enabled) {\n  throw new Error(\"Server has no Python plugin support; skip plugin setup\");\n}","typeGuard":null,"tryCatchPattern":"// Rust client\nmatch resp {\n    Err(e) if e.to_string().contains(\"Python plugins not enabled\") => {\n        warn!(\"processing engine disabled on this server; skipping plugin setup\");\n    }\n    other => other?,\n}","preventionTips":["Standardize on a Python-enabled build/image for all environments","Document required startup flags (--plugin-dir, python feature) in deployment configs","Gate plugin provisioning steps on a capability check"],"tags":["http-api","plugins","feature-gating","config"],"backgroundTag":"feature-not-enabled","analyzedSha":"06200ef96ba82c5f6727e5038a83af8e722c6875","analyzedAt":"2026-09-19T12:55:30.003Z","contentChangedAt":"2026-09-19T12:55:30.003Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}