F.1 ledgersmb.conf

The use of ledgersmb.conf is deprecated as of 1 Jan 2023 in favor of ledgersmb.yaml and only remains here for historical reasons.

The environment variable for controlling the configuration is LSMB_CONFIG_FILE.

By default LSMB_CONFIG_FILE points to /etc/ledgersmb/ledgersmb.conf and can be set to an alternate location.

[main] Section


Set language for login and admin pages.


Set the date format for the admin pages. The default is yyyy-mm-dd. Unset means detected from the browser)


Specifies the logging level to be used. This setting is ignored when the log_config setting is supplied and indicates an existing file. Available values are OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE.


Set the name of the extended logging configuration file. This file uses the log4j/Log::Log4perl syntax described at https://metacpan.org/pod/Log::Log4perl#Configuration-files


This is the Dojo theme that is used by default when no other theme has been selected. The default if unset is claro. Other values can be nihilo, soria, and tundra.


Indicates which authentication module is to be used; default is DB, referring to LedgerSMB::Auth::DB.


Determines if HTML templates used for the LedgerSMB UI will be stored in precompiled form for improved performance. The value 0 (zero) means no caching; the value 1 means caching in the directory $(tempdir)/lsmb_templates; systems running multiple LedgerSMB instances with customized UIs should use separate values for tempdir for that reason

[environment] Section

Sets shell environment variables when starting up.


If the server can’t find applications, append to the path. For example: PATH=/bin:/usr/bin:/usr/local/bin:/usr/local/pgsql/bin


On some operating systems like macOS the perl path may need to be set. For example, on macOS using Fink’s Perl libs it might be set like: PERL5LIB=/sw/lib/perl5

[paths] Section


Templates base directory. Typically set to templates.


Images base directory. Typically set to UI/images.


Path to locale files. Defaults to locale/po.


Location where compiled templates are stored. When relative, appended to the directory specified by File::Spec->tmpdir().

Defaults to lsmb_templates.


Directory where workflow files are stored. Defaults to workflows


Directory where custom workflow files are stored. Custom workflows are used to override behavior of the default workflows by providing actions, conditions, etc. with the same name and type or by providing workflows of the same type with additional states and actions. Defaults to custom_workflows.

[programs] Section

Setup the various helper programs that can be used with LedgerSMB.

[mail] Section


The host name of the smtp server. If provided, then do not use local sendmail. Note that one of sendmail or smtphost has to be provided for email to work.


Path the local sendmail executable. If provided then do not use an smtp server. Note that one of sendmail or smtphost has to be provided for email to work.


The port number of the smtp server. Note this might vary depending on whether TLS or SSL is used.


The smpt server account name


The smtp server authentication method


The smtp server password


Set to enable e-mail delivery of backups. For example: backup_email_from = backups@lsmb_hosting.com


The timeout value in seconds.


If unset or ’no’ then do not use either TLS or SSL. If ’yes’ then use TLS and if ’tls’ use SSL for the smtp connection.


Override the default host name for helo.

[printers] Section

This section contains a list of printers and the commands to be executed in order for the output to be sent to the given printer with the document to be printed fed to the program through standard input.

The example below shows how to send standard input data to a printer called “laser” when selecting the item “Laser” in the LedgerSMB printer selection drop down.

Laser = lpr -Plaser

Or to an Epson Printer.

Epson = lpr -PEpson

[database] Section


Name of the host to connect to. See the documentation of the -h command line option at https://www.postgresql.org/docs/current/static/app-psql.html for more information (documentation unchanged since before 8.3, so applies to older versions as well)


Port number to be used to connect to. See the documentation of the -p option at the same URL as the previous item


Database to connect to when the “Company” entry field in the login screen is left blank


The name space the company resides in; expert setting – should not be used (default is “public”)


Selects whether to use Secure Sockets Layer (SSL) over TCP connections or not; can be “require”, “allow”, “prefer” or “disable”. Default is “prefer”.