Changing Citadel Configuration From the Command Line

Important: This is not the normal or recommended way to configure Citadel. Under ordinary circumstances, all server settings should be managed through the graphical System configuration menus in WebCit, or through the text client. Modifying raw configuration parameters directly can make your Citadel server unstable or unbootable if incorrect values are entered.

However, if you are writing automated deployment scripts, or if you need to inspect or adjust settings when WebCit is temporarily unavailable, Citadel provides the sendcommand utility to query and set configuration keys directly against the server.

Listing All Configuration Keys and Values

To view every configuration parameter stored in the server database:

sendcommand 'CONF LISTVAL'

Viewing a Specific Setting

To inspect the current value of an individual configuration key:

sendcommand 'CONF GETVAL|key_name'

Modifying a Setting

To update the value of an individual configuration key:

sendcommand 'CONF PUTVAL|key_name|new_value'

Depending on the parameter modified, you may need to restart the Citadel server for the new value to take effect across all service threads.