Skip to main content

Celonis Product Documentation

Required directories and registry keys for Task Mining

The Task Mining Client software on a user's machine needs access to these directories and registry keys to work as expected. For the full system requirements for the Task Mining Client Software, see Task Mining Desktop Application.

In a virtual desktop infrastructure (VDI) environment, these directories and registry keys must be persisted between sessions. For the VDI options and limitations for Task Mining, see Virtual desktop infrastructure options for Task Mining.

Important

Any references to third-party products or services do not constitute Celonis Product Documentation nor do they create any contractual obligations. This material is for informational purposes only and is subject to change without notice.

Celonis does not warrant the availability, accuracy, reliability, completeness, or usefulness of any information regarding the subject of third-party services or systems.

Required directories

Directory

Access type

Description

%ProgramFiles(x86)%\Celonis SE\Celonis Task Mining

  • Read access during runtime.

  • Write access during installation.

Installation directory when installed for all users of a machine.

%LOCALAPPDATA%\Celonis SE\Celonis Task Mining

  • Read access during runtime.

  • Write access during installation.

Installation directory when installed for the current user only.

%USERPROFILE%\CelonisTaskMining

Read/write access during runtime.

Contains cached parquet and image files. Can be configured in the project configuration.

%LOCALAPPDATA%\Celonis\TaskMiningClient

Read/write access during runtime.

Contains cached configuration, application settings and logs.

%LOCALAPPDATA%\Celonis_SE\CelonisTaskMining.Client._Url_< 32 alphanumeric characters><version of the client>

Read/write access during runtime.

Contains required application settings.

We recommend making the entire %LOCALAPPDATA%\Celonis_SE directory persistent to ensure files are still available when the Task Mining Client software is updated.

<Personal Special Folder>

For further information, see Environment.SpecialFolder Enum.

Write access during runtime.

Contains crash report files.

<Personal Special Folder>/Celonis Task Mining

For further information, see Environment.SpecialFolder Enum.

Write access during runtime.

Contains error log files if configuration could not be loaded.

Required registry keys

Note

  • For KMU, when the client is installed per machine context (admin), the key will be under HKLM. When installed per user context, the key will be under HKCU.

  • For <SOFTWARE>: On 32-bit Windows systems, replace with Software. On 64-bit Windows systems, replace with Software\Wow6432Node.

If the registry key for autostart is not writable, the application will not autostart at system start.

Registry key

Access type

Description

HKCU\<Software>\Celonis\TaskMining\installed

Write access during installation.

Registers installation of the application.

HKLM\<Software>\Celonis\TaskMining\activation_link_url

  • Read access during runtime.

  • Write access during installation.

Activation link to automatically activate the client on the first start.

HKLM\<Software>\Celonis\TaskMining\client_certificate_subject

  • Read access during runtime.

  • Write access during installation.

Client certificate subject used for secure gateway authentication.

HKLM\<Software>\Celonis\TaskMining\client_working_directory

  • Read access during runtime.

  • Write access during installation.

Working directory of the Task Mining client.

HKLM\<Software>\Celonis\TaskMining\connection_timeout

  • Read access during runtime.

  • Write access during installation.

Custom connection timeout.

HKLM\<Software>\Celonis\TaskMining\custom_extension_ids

  • Read access during runtime.

  • Write access during installation.

Custom browser extension IDs for self-hosted rollouts.

HKLM\<Software>\Celonis\TaskMining\secure_gateway_server

  • Read access during runtime.

  • Write access during installation.

Host URLs of the secure gateway server.

HKLM\<Software>\Celonis\TaskMining\service_principal_name

  • Read access during runtime.

  • Write access during installation.

Service principal names used for the on-premise Task Mining gateway.

HKMU\<Software>\Celonis\TaskMining\extension_socket_port

  • Read access during runtime.

  • Write access during installation.

Custom port for the Chrome Extension.

HKMU\<Software>\Google\Chrome\Extensions\ndfcgjlpabkombgfpckhglibdhnipbfl\update_url

Write access during installation.

Update URL of the Chrome Extension.

HKMU\<Software>\Microsoft\Edge\Extensions\ndfcgjlpabkombgfpckhglibdhnipbfl\update_url

Write access during installation.

Update URL of the Edge Extension.

HKMU\<Software>\Microsoft\Windows\CurrentVersion\Run\CelonisTaskMining

Write access during installation.

Autostart entry for the Task Mining client.

HKMU\<Software>\Classes\CelonisTaskMining\(Default)

Write access during installation.

Registers the Task Mining-specific URL.

HKMU\<Software>\Classes\CelonisTaskMining\shell\open\command\(Default)

Write access during installation.

Registers the shell command to open the client from URL.

HKMU\<Software>\Classes\CelonisTaskMining\URL Protocol

Write access during installation.

Enables browsers to open the Task Mining client from URL.