KNIME Documentation

Hub & Executor Configuration ​

This page documents how to configure the Python environment on a KNIME Executor running inside KNIME Business Hub, including customization profile settings, knime.ini flags, and REST API calls.

Customization profile settings ​

The KNIME Executor uses customization profiles. Add the following keys to your .epf file as needed.

Conda installation path ​

Only needed if Conda / Miniforge is installed in a non-default location (default in executor images: /home/knime/miniconda3/).

ini
/instance/org.knime.conda/condaDirectoryPath=<path to conda installation dir>

Python Integration (current) ​

ini
# "bundled" (default), "conda", or "manual"
/instance/org.knime.python3.scripting.nodes/pythonEnvironmentType=bundled
/instance/org.knime.python3.scripting.nodes/bundledCondaEnvPath=org_knime_pythonscripting

# Only if pythonEnvironmentType=conda
/instance/org.knime.python3.scripting.nodes/python3CondaEnvironmentDirectoryPath=<path>

# Only if pythonEnvironmentType=manual
/instance/org.knime.python3.scripting.nodes/python3Path=<path>

Python Integration (legacy) ​

ini
# "conda" or "manual"
/instance/org.knime.python2/pythonEnvironmentType=conda
/instance/org.knime.python2/defaultPythonOption=python3
/instance/org.knime.python2/serializerId=org.knime.python2.serde.arrow

# Only if pythonEnvironmentType=conda
/instance/org.knime.python2/python3CondaEnvironmentDirectoryPath=<path>

# Only if pythonEnvironmentType=manual
/instance/org.knime.python2/python3Path=<path>

Deep Learning Integration ​

ini
# "python" reuses section B config; "dl" uses custom config below
/instance/org.knime.dl.python/pythonConfigSelection=python

# Only if pythonConfigSelection=dl
/instance/org.knime.dl.python/pythonEnvironmentType=conda
/instance/org.knime.dl.python/librarySelection=keras
/instance/org.knime.dl.python/kerasCondaEnvironmentDirectoryPath=<path>
/instance/org.knime.dl.python/tf2CondaEnvironmentDirectoryPath=<path>
/instance/org.knime.dl.python/serializerId=org.knime.python2.serde.arrow

knime.ini flags ​

FlagEffect
-Dknime.python.cacerts=APMakes Python trust the same CA certificates as the KNIME Analytics Platform. Resolves SSL errors with self-signed certificates.

REST API: configure an Executor's JVM arguments ​

1 – Get the execution context ID ​

GET api.<base-url>/execution-contexts

2 – Set JVM arguments ​

PUT api.<base-url>/execution-contexts/<execution-context-id>
json
{
  "operationInfo": {
    "vmArguments": ["-Dknime.python.cacerts=AP"]
  }
}

Next steps ​