Appendix C. Configuration

In order to connect to the RT server, rt needs a few pieces of information. The essential information rt requires is a server to connect to and access information for that server, but several other nonessential variables also are useful to know. Table C-1 lists the available configuration options.

Table C-1. Command-line configuration options




Server name


Specify which RT server to access. This should be a valid hostname. (If you can successfully ping the server using this name, everything should work as expected.)



A valid username with access to the server defined.



The appropriate password for the username defined.

Order by


How to arrange the results of the query for actions that produce results.

Query string


A default query to use when an action requires a query but one isn’t specified.

Debug level


A numeric value from 1 to 3 specifying how much rt should log. This is useful for debugging error messages or spurious failures. In normal usage this would not be set and would default to the value 0.

Configuration file


Tells rt to use a specific configuration file rather than search for the default .rtrc.

Text editor


Sets which editor to use when working from the command line. Defaults to vi if this variable is not set.

You can provide the above information to rt using environment variables or a configuration file, typically .rtrc. The configuration file can’t define ...

Get RT Essentials now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.