Lesli Initializer

This guide explains the configuration options available in config/initializers/lesli.rb.

Use this file to customize the core behavior of your Lesli-based application, including system identity, localization, date and time formats, security settings, theme options, layout features, and mailer paths.

Generate the Initializer

If you have not already generated the Lesli initializer, run:

rails generate lesli:install

This command creates the base Lesli configuration file:

config/initializers/lesli.rb

Lesli provides sensible defaults, so in most cases you only need to change the settings relevant to your application.

Full Configuration Example

Lesli.configure do |config|

  # Enable or disable demo mode.
  config.demo = false

  # Installation identifier.
  config.instance = "Lesli"

  # Organization details displayed throughout the system.
  config.company = {
    name: "Lesli",
    email: "hello@lesli.tech",
    tagline: "The Open SaaS Development Platform."
  }

  # Supported languages (requires LesliBabel).
  config.locales = {
    en: "English",
    de: "Deutsch",
    pl: "Polski",
    nl: "Dutch",
    es: "Español",
    it: "Italiano",
    fr: "Français",
    pt: "Português"
  }

  # Date and time settings.
  config.datetime = {
    time_zone: "America/Guatemala",
    start_week_on: "monday",
    formats: {
      date: "%d/%m/%Y",
      time: "%H:%M",
      date_time: "%d/%m/%Y %H:%M",
      date_words: "%A, %B %d, %Y",
      date_time_words: "%A, %B %d, %Y, %H:%M",
      date_time_words_pm: "%A, %B %d, %Y, %I:%M %p",
      date_time_words_day: "%A, %B %d, %Y, %H:%M"
    }
  }

  # Security settings.
  config.security = {
    password: "Test123!",
    enable_debug: false,
    enable_becoming: false,
    enable_analytics: true,
    enable_login_otp: true,
    enable_login_link: true,
    allow_multiaccount: true,
    allow_registration: true
  }

  # Theme colors.
  config.theme = {
    color_primary: "#193d8d",
    color_sidebar: "#ffffff",
    color_header: "transparent",
    color_footer: "transparent",
    color_background: "#eef2f6",
    color_sidebar_hover: "#dee7ec"
  }

  # Layout options.
  config.layout = {
    tasks: true,
    babel: false,
    profile: true,
    notifications: true
  }

  # Default mailer template path.
  config.mailer = {
    templates: "lesli_mailer/emails/lesli"
  }

  # Redirect path after login.
  config.path_after_login = "/"
  config.path_after_login = "/dashboard" if defined?(LesliDashboard)
end

Common Configuration Areas

Demo Mode

Use config.demo to enable or disable demo-specific behavior.

config.demo = false

Instance and Company Information

Use config.instance and config.company to define how your application is identified across the platform.

config.instance = "Lesli"
config.company = {
  name: "Lesli",
  email: "hello@lesli.tech",
  tagline: "The Open SaaS Development Platform."
}

Localization

Use config.locales to define the languages available in your application. This requires LesliBabel.

Date and Time

Use config.datetime to control the application time zone, the first day of the week, and the date and time formats used across the interface.

Security

Use config.security to define system-wide security behavior, including registration, login options, development passwords, and debugging features.

Theme

Use config.theme to customize the visual appearance of the platform.

Layout

Use config.layout to enable or disable selected layout features such as notifications, profile access, task shortcuts, or translation tools.

Mailer

Use config.mailer to define the default path for email templates.

Redirect After Login

Use config.path_after_login to control the default destination after authentication.

Overriding Only What You Need

You do not need to redefine the full configuration file. You can override only the values relevant to your application.

Lesli.configure do |config|
  config.demo = true
  config.security[:allow_multiaccount] = false
end

This keeps your initializer smaller and easier to maintain.

Environment Variable Overrides

Some settings can also be overridden with environment variables.

Use the following format:

LESLI_<SECTION>_<KEY>

Example:

LESLI_SECURITY_ENABLE_DEBUG=false

This is useful for deployment environments where configuration should not be stored directly in source code.

 Edit this page

Last Update: 2026/03/15