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