To configure Lita, edit the file lita_config.rb generated by the lita new command. This is just a plain Ruby file that will be evaluated when Lita is starting up. A Lita config file looks something like this:

Lita.configure do |config| = "Sir Bottington"
  config.robot.mention_name = "bottington"
  config.robot.alias = "/"
  config.robot.adapter = :example_chat_service
  config.adapters.example_chat_service.username = "bottington"
  config.adapters.example_chat_service.password = "secret"
  config.redis[:host] = ""
  config.handlers.karma.cooldown = 300
  config.handlers.google_images.safe_search = :off

If you want to use a config file with a different name or location, invoke lita with the -c option and provide the path to the config file.

The following configuration attributes are available:

Name Type Description Default String The display name Lita will use on the chat service. "Lita"
config.robot.mention_name String The name Lita will look for in messages to determine if the message is being addressed to it. Usually this is the same as the display name, but in some cases it may not be. For example, in HipChat, display names are required to be a first and last name, such as "Lita Bot", whereas the mention system would use a name like "LitaBot".
config.robot.alias String The alias Lita will look for in messages to determine if the message is being addressed to it. Useful if you want to use something shorter than Lita's name or mention name, such as a slash, to send it a command. None
config.robot.adapter Symbol, String The adapter to use. :shell
config.robot.locale Symbol, String The locale code for the language Lita's user interface will use. I18n.locale
config.robot.log_level Symbol, String The severity level of log messages to output. Valid options are, in order of severity: :debug, :info, :warn, :error, and :fatal. For whichever level you choose, log messages of that severity and greater will be output. :info
config.robot.admins Array<String> An array of string user IDs which will tell Lita which users are considered administrators. Only these users will have access to Lita's "auth" commands. The IDs needed for this attribute can be found using the built-in user info command. nil
config.robot.error_handler #call A callable object invoked whenever an exception is raised. -> (error) {}
config.redis Hash Options for the Redis connection. {} String The host Lita's web server will bind to. ""
config.http.port Integer, String The port Lita's web server will listen on. 8080
config.http.min_threads Integer, String The minimum number of system threads Lita's web server will use. 0
config.http.max_threads Integer, String The maximum number of system threads Lita's web server will use. The number will vary automatically based on load, but it will never go above this number. 16
config.http.middleware Lita::MiddlewareRegistry Rack middleware to be added to the built-in web server. Call #use on this object, passing it a Rack middleware class, and any initialization arguments or block the middleware needs. This is identical to the interface of Rack::Builder#use.
config.adapter Lita::Config Deprecated: Options for the chosen adapter. Some older adapters may use this instead of config.adapters. See the adapter's documentation. N/A
config.adapters Object Adapters may choose to expose a config object here with their own options. See the adapter's documentation. N/A
config.handlers Object Handlers may choose to expose a config object here with their own options. See the handler's documentation. N/A


Lita is internationalized and can use any localization. Setting your preferred localization is as easy as setting the configuration attribute config.robot.locale to the preferred language code. If a translation is not available for the selected locale, Lita will fall back to the default locale, which is English. Locales can be specified with an optional territory, and will fall back to the general language if a territory-specific translation is not available.

Lita.configure do |config|
  # Tries Mexican Spanish, falling back to Spanish, and then to English.
  config.robot.locale = "es-MX"

  # Tries Spanish, falling back to English.
  config.robot.locale = "es"

If the environment variable LANG is set, Lita will use its value for setting the locale upon start up. This value is overriden if config.robot.locale is set.