config/kivitendo.conf.default

   1 [authentication]
   2 # The cleartext password for access to the administrative part.  It
   3 # can only be changed in this file, not via the administrative
   4 # interface.
   5 admin_password = admin123
   6
   7 # Which module to use for authentication. Valid values are 'DB' and
   8 # 'LDAP'.  If 'LDAP' is used then users cannot change their password
   9 # via kivitendo.
  10 module = DB
  11
  12 # The cookie name can be changed if desired.
  13 cookie_name = kivitendo_session_id
  14
  15 # The number of minutes a session is valid. The default value is eight
  16 # hours.
  17 session_timeout = 480
  18
  19 # The number of seconds to penalize failed login attempts. 0 disables
  20 # it.
  21 failed_login_penalty = 5
  22
  23 [authentication/database]
  24 # Connection information for the database with the user and group
  25 # inforamtion.  This information is always needed, even if LDAP is
  26 # used for authentication, as the user information is stored in this
  27 # database while LDAP is only used for password verification.
  28 #
  29 # If 'module' is set to 'DB' then this database also contains the
  30 # users' passwords.
  31 host     = localhost
  32 port     = 5432
  33 db       = kivitendo_auth
  34 user     = postgres
  35 password =
  36
  37 [authentication/ldap]
  38 # This section is only relevant if 'module' is set to 'LDAP'. It names
  39 # the LDAP server the passwords are verified against by doing a LDAP
  40 # bind operation.
  41 #
  42 # At least the parameters 'host', 'attribute' and 'base_dn' have to be
  43 # specified.
  44 #
  45 # tls:       Activate encryption via TLS
  46 # attribute: Name of the LDAP attribute containing the user's login name
  47 # base_dn:   Base DN the LDAP searches start from
  48 # filter:    An optional LDAP filter specification. The string '<%login%>'
  49 #            is replaced by the user's login name before the search is started.
  50 # bind_dn and bind_password:
  51 #            If searching the LDAP tree requires user credentials
  52 #            (e.g. ActiveDirectory) then these two parameters specify
  53 #            the user name and password to use.
  54 host          = localhost
  55 port          = 389
  56 tls           = 0
  57 attribute     = uid
  58 base_dn       =
  59 filter        =
  60 bind_dn       =
  61 bind_password =
  62
  63 [system]
  64 # Set language for login and admin forms. Currently "de" (German)
  65 # and "en" (English, not perfect) are available.
  66 language = de
  67
  68 # Set default_manager for admin forms. Currently "german"
  69 # and "swiss" are available.
  70 default_manager = german
  71
  72 # The memory limits given here determine the maximum process size
  73 # (vsz, the total amount of memory this process uses including memory
  74 # swapped out or shared with other processes) or resident set size
  75 # (rss, the amount of memory not swapped out/shared with other
  76 # processes). If either limit is reached at the end of the request
  77 # then the kivitendo process will exit.
  78 #
  79 # This only makes sense when running under FCGI. The FCGI manager will
  80 # then automatically start a new process.
  81 #
  82 # Numbers can be postfixed with KB, MB, GB. If no number is given or
  83 # the number is 0 then no checking will be performed.
  84 memory_limit_rss =
  85 memory_limit_vsz =
  86
  87 [paths]
  88 # path to temporary files (must be writeable by the web server)
  89 userspath = users
  90 # spool directory for batch printing
  91 spool = spool
  92 # templates base directory
  93 templates = templates
  94 # Path to the old memberfile (ignored on new installations)
  95 memberfile = users/members
  96
  97 [mail_delivery]
  98 # Delivery method can be 'sendmail' or 'smtp'. For 'method = sendmail' the
  99 # parameter 'mail_delivery.sendmail' is used as the executable to call. If
 100 # 'applications.sendmail' still exists (backwards compatibility) then
 101 # 'applications.sendmail' will be used instead of 'mail_delivery.sendmail'.
 102 # If method is empty, mail delivery is disabled.
 103 method = smtp
 104 # Location of sendmail for 'method = sendmail'
 105 sendmail = /usr/sbin/sendmail -t<%if myconfig_email%> -f <%myconfig_email%><%end%>
 106 # Settings for 'method = smtp'. Only set 'port' if your SMTP server
 107 # runs on a non-standard port (25 for 'security=none' or
 108 # 'security=tls', 465 for 'security=ssl').
 109 host = localhost
 110 #port = 25
 111 # Security can be 'tls', 'ssl' or 'none'. Unset equals 'none'. This
 112 # determines whether or not encryption is used and which kind. For
 113 # 'tls' the module 'Net::SSLGlue' is required; for 'ssl'
 114 # 'Net::SMTP::SSL' is required and 'none' only uses 'Net::SMTP'.
 115 security = none
 116 # Authentication is only used if 'login' is set. You should only use
 117 # that with 'tls' or 'ssl' encryption.
 118 login =
 119 password =
 120
 121 [applications]
 122 # Location of OpenOffice.org writer
 123 openofficeorg_writer = oowriter
 124 # Location of the X virtual frame buffer used for OpenOffice
 125 xvfb = Xvfb
 126 # Location of the html2ps binary
 127 html2ps = html2ps
 128 # Location of the Ghostscript binary
 129 ghostscript = gs
 130 # Location of the pdflatex (or compatible, e.g. xetex) binary
 131 latex = pdflatex
 132 # Location of the Python interpreter to use when converting from
 133 # OpenDocument to PDF. Some distributions compile UNO support only
 134 # into binaries located in different locations than the main Python
 135 # binary.
 136 python_uno = python
 137
 138 # Location of the aqbanking binary to use when converting MT940 files
 139 # into the kivitendo import format
 140 aqbanking = /usr/bin/aqbanking-cli
 141
 142 [environment]
 143 # Add the following paths to the PATH environment variable.
 144 path = /usr/local/bin:/usr/X11R6/bin:/usr/X11/bin
 145 # Add the following paths to the PERL5LIB environment variable.
 146 # "/sw/lib/perl5" is for Mac OS X with Fink's Perl.
 147 lib = /sw/lib/perl5
 148 # Add the following paths to the PYTHONPATH environment variable for
 149 # locating Python modules. Python is used when converting OpenDocument
 150 # files into PDF files.
 151 python_uno_path =
 152
 153 [print_templates]
 154 # If you have LaTeX installed set to 1
 155 latex = 1
 156 # Minimal support for Excel print templates
 157 excel = 0
 158 # Enable or disable support for OpenDocument print templates
 159 opendocument = 1
 160 # Chose whether or not OpenOffice should remain running after a
 161 # conversion. If yes then the conversion of subsequent documents will
 162 # be a lot faster. You need to have Python and the Python UNO bindings
 163 # (part of OpenOffice) installed.
 164 openofficeorg_daemon = 1
 165 openofficeorg_daemon_port = 2002
 166
 167 [task_server]
 168 # Set to 1 for debug messages in /tmp/kivitendo-debug.log
 169 debug = 0
 170 # Chose a system user the daemon should run under when started as root.
 171 run_as =
 172
 173 [task_server/notify_on_failure]
 174 # If you want email notifications for failed jobs then set this to a
 175 # kivitendo user (login) name. The subject can be changed as well.
 176 send_email_to  =
 177 # The "From:" header for said email.
 178 email_from     = kivitendo Daemon <root@localhost>
 179 # The subject for said email.
 180 email_subject  = kivitendo Task-Server: Hintergrundjob fehlgeschlagen
 181 # The template file used for the email's body.
 182 email_template = templates/webpages/task_server/failure_notification_email.txt
 183
 184 [periodic_invoices]
 185 # The user name a report about the posted and printed invoices is sent
 186 # to.
 187 send_email_to  = mb
 188 # The "From:" header for said email.
 189 email_from     = kivitendo Daemon <root@localhost>
 190 # The subject for said email.
 191 email_subject  = Benachrichtigung: automatisch erstellte Rechnungen
 192 # The template file used for the email's body.
 193 email_template = templates/webpages/oe/periodic_invoices_email.txt
 194
 195 [self_test]
 196
 197 # modules to be tested
 198 # Add without SL::BackgroundJob::SelfTest:: prefix
 199 # Separate with space.
 200 modules = Transactions
 201
 202 # you probably don't want to be spammed with "everything ok" every day. enable
 203 # this when you add new tests to make sure they run correctly for a few days
 204 send_email_on_success = 0
 205
 206 # will log into the standard logfile
 207 log_to_file = 0
 208
 209 # user login (!) to send the email to.
 210 send_email_to  =
 211 # will be used to send your report mail
 212 email_from     =
 213 # The subject line for your report mail
 214 email_subject  = kivitendo self test report
 215 # template. currently txt and html templates are recognized and correctly mime send.
 216 email_template = templates/mail/self_test/status_mail.txt
 217
 218 [console]
 219 # Automatic login will only work if both "client" and "login" are
 220 # given.  "client" can be a client's database ID or its name. "login"
 221 # is simply a user's login name.
 222 client =
 223 login =
 224
 225 # autorun lines will be executed after autologin.
 226 # be warned that loading huge libraries will noticably lengthen startup time.
 227 #autorun = require "bin/mozilla/common.pl";
 228 #        = use English qw(-no_match_vars);
 229 #        = use List::Util qw(min max);
 230 #        = sub take { my $max = shift; my $r = ref($_[0]) eq 'ARRAY' ? $_[0] : \@_; return @{$r}[0..List::Util::min($max, scalar(@{$r})) - 1]; }
 231
 232 # location of history file for permanent history
 233 history_file = users/console_history
 234
 235 # location of a separate log file for the console. everything normally written
 236 # to the kivitendo log will be put here if triggered from the console
 237 log_file = /tmp/kivitendo_console_debug.log
 238
 239 [testing]
 240
 241 # Several tests need a database they can alter data in freely. This
 242 # database will be dropped & created before any other test is run. The
 243 # following parameters must be given:
 244 [testing/database]
 245 host     = localhost
 246 port     = 5432
 247 db       =
 248 user     = postgres
 249 password =
 250 template = template1
 251
 252 [devel]
 253 # Several settings related to the development of kivitendo.
 254
 255 # "client" is used by several scripts (e.g. rose_auto_create_model.pl)
 256 # when they need access to the database. It can be either a client's
 257 # database ID or its name.
 258 client =
 259
 260 [debug]
 261 # Use DBIx::Log4perl for logging DBI calls. The string LXDEBUGFILE
 262 # will be replaced by the file name configured for $::lxdebug.
 263 dbix_log4perl = 0
 264 dbix_log4perl_config = log4perl.logger = FATAL, LOGFILE
 265                      = log4perl.appender.LOGFILE=Log::Log4perl::Appender::File
 266                      = log4perl.appender.LOGFILE.filename=LXDEBUGFILE
 267                      = log4perl.appender.LOGFILE.mode=append
 268                      = log4perl.appender.LOGFILE.Threshold = ERROR
 269                      = log4perl.appender.LOGFILE.layout=PatternLayout
 270                      = log4perl.appender.LOGFILE.layout.ConversionPattern=[%r] %F %L %c - %m%n
 271                      = log4perl.logger.DBIx.Log4perl=DEBUG, A1
 272                      = log4perl.appender.A1=Log::Log4perl::Appender::File
 273                      = log4perl.appender.A1.filename=LXDEBUGFILE
 274                      = log4perl.appender.A1.mode=append
 275                      = log4perl.appender.A1.layout=Log::Log4perl::Layout::PatternLayout
 276                      = log4perl.appender.A1.layout.ConversionPattern=%d %p> %F{1}:%L %M - %m%n
 277
 278 # Activate certain global debug messages. If you want to combine
 279 # several options then list them separated by spaces.
 280 #
 281 # Possible values include:
 282 #   NONE   - no debug output (default)
 283 #   INFO
 284 #   DEBUG1
 285 #   DEBUG2
 286 #   QUERY              - Dump SQL queries (only in legacy code; see also "dbix_log4perl" above)
 287 #   TRACE              - Track function calls and returns
 288 #   BACKTRACE_ON_ERROR - Print a function call backtrace when $form->error() is called
 289 #   REQUEST_TIMER      - Log timing of HTTP requests
 290 #   REQUEST            - Log each request. Careful! Passwords get filtered, but
 291 #                        there may be confidential information being logged here
 292 #   WARN               - warnings
 293 #   ALL                - all possible debug messages
 294 #
 295 #   DEVEL              - sames as "INFO QUERY TRACE BACKTRACE_ON_ERROR REQUEST_TIMER"
 296 #
 297 # Example:
 298 #   global_level = TRACE QUERY
 299 global_level = NONE
 300
 301 # Activate monitoring of the content of $form. If it is active then
 302 # monitoring can be turned on for certain variables with the
 303 # following:
 304 #   $form->{"Watchdog::<variable>"} = 1;
 305 # Monitoring has a performance cost and is therefore deactivated by
 306 # default.
 307 watch_form = 0
 308
 309 # If you want to debug the creation of LaTeX files then set this to 1.
 310 # That way the temporary LaTeX files created during PDF creation are
 311 # not removed and remain in the "users" directory.
 312 keep_temp_files = 0
 313
 314 # Restart the FastCGI process if changes to the program or template
 315 # files have been detected. The restart will occur after the request
 316 # in which the changes have been detected has completed.
 317 restart_fcgi_process_on_changes = 0
 318
 319 # The file name where the debug messages are written to.
 320 file_name = /tmp/kivitendo-debug.log
 321
 322 # If set to 1 then the installation will be kept unlocked even if a
 323 # database upgrade fails.
 324 keep_installation_unlocked = 0
 325
 326 # If set to 1 then all resource links (JavaScript, CSS files) output
 327 # via $::request->{layout}->use_stylesheet() / use_javascript() will
 328 # be made unique by appending a random GET parameter. This will cause
 329 # the web browser to always reload the resources.
 330 auto_reload_resources = 0
 331
 332 # If set to 1 each exception will include a full stack backtrace.
 333 backtrace_on_die = 0
 334
 335 [cti]
 336 # If you want phone numbers to be clickable then this must be set to a
 337 # command that does the actually dialing. Within this command three
 338 # variables are replaced before it is executed:
 339 #
 340 # 1. <%phone_extension%> and <%phone_password%> are taken from the user
 341 #    configuration (changeable in the admin interface).
 342 # 2. <%number%> is the number to dial. It has already been sanitized
 343 #    and formatted correctly regarding e.g. the international dialing
 344 #    prefix.
 345 #
 346 # The following is an example that works with the OpenUC telephony
 347 # server:
 348 # dial_command = curl --insecure -X PUT https://<%phone_extension%>:<%phone_password%>@IP.AD.DR.ESS:8443/sipxconfig/rest/my/call/<%number%>
 349 dial_command =
 350 # If you need to dial something before the actual number then set
 351 # external_prefix to it.
 352 external_prefix = 0
 353 # The prefix for international calls (numbers starting with +).
 354 international_dialing_prefix = 00