Internal Component Passwords

KX Delta Platform uses a set of internal component users for communication between platform services. Prior to 5.0.0, the passwords for these users were fixed at install time and could not be changed. They can now be reset by an Administrator via the UI or the kxp CLI.

Component users

User	Description
deltacomponent	Internal user for core control component communication
kxemail	Internal user for the email service
deltadocgen	Internal user for the document generation process
deltaserver	Internal user for the Appserver process
deltadaemon	Internal user for the DeltaDaemon process
kxconnect	Internal user for the KXConnect process

Resetting a password

Via the UI

Log in as an Administrator and navigate to Entitlements > Users — search for it using the navigation search bar if needed. Select the relevant user and change their password using the Change password option in the user editor.

Via the CLI

./kxp user reset <internal-user> --password=<new-password>

For example:

./kxp user reset deltacomponent --password=mypassword

Password changes take effect when the relevant component process is restarted. The passwords are stored encrypted in the password store file, located at:

$DELTAHOME/delta-data/DeltaControlData/tdir

Multi-node deployments

Where possible, reset passwords when the Control instance is running on all nodes — the change will sync across the cluster automatically.

Scenario	Action
Both nodes available	Reset via UI or CLI as normal
One node available	Reset via UI or CLI, then copy .pwstore from the leader node to the follower before restarting components there
Both nodes unavailable	No options — a UI or CLI connection is required to reset passwords

If component processes on the follower node fail to connect after a password reset, the password store file may be out of sync. Copy the .pwstore from the leader node to the equivalent location on the follower node and restart the affected components.