• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS

NAME

rt-config - Manage RT configurations

SYNOPSIS

    rt-config show DefaultQueue
    rt-config show PriorityAsString
    rt-config show PriorityAsString --format perl
    rt-config show PriorityAsString --format json

    # Update configs in Database
    rt-config edit DefaultQueue     # Invoke default editor to set the new value
    rt-config edit PriorityAsString --value '{"Default": {"High": 100, "Low": 0, "Medium": 50}}'

    # Revert config changes to the file version
    rt-config reset DefaultQueue
    rt-config reset PriorityAsString

DESCRIPTION

RT stores configuration in two layers: config files (RT_SiteConfig.pm and related files) and the database. Database-stored values override file-based values and can be changed at runtime without restarting the server.

rt-config lets you view, edit, and reset database-stored configuration from the command line.

show

Display the effective value of a configuration option, whether it comes from a config file or the database.

edit

Set a configuration option in the database. If --value is not provided, your default editor is opened with the current value. Only options that are not marked as immutable or obfuscated can be edited.

reset

Remove a database-stored override so the config file value takes effect again.

OPTIONS

--value

For edit only, you can specify the new value using this option. Reference values must be encoded as json.

--format

For show only. This is used to format reference values. Available options are perl and json. By default, it prefers perl and also falls back to perl when json is not applicable.