= Configuration Options =

Various configuration options can be set to influence how various subsystems in the framework go about their work. Setting these options is done by passing them into the `Application` constructor as keyword arguments, or by setting the values in the `app.config` dictionary.

== General ==

 `debug`:: Whether debugging and developer-oriented error pages should be enabled

== Email ==

 `email_to`:: The default recipient of sent emails
 `error_email_from`:: The email address to use in the `From` header of outgoing [wiki:ErrorHandling#ErrorEmailNotification error notification mails]
 `smtp_server`:: The host name of the SMTP server to use for outgoing mail
 `smtp_port`:: The port number of the SMTP server (default 25)
 `smtp_username`:: The username to use for authentication against the SMTP server
 `smtp_password`:: The password to use for authentication against the SMTP server 
 `smtp_tls`:: Whether to use TLS for the SMTP server connection.

== Internationalization ==

 `locale`:: The default locale to use
 `timezone`:: The timezone to use for date/time display

== Templating ==

 `doctype`:: The default `DOCTYPE` to use for rendered HTML pages
 `reload_templates`:: Whether templates should be automatically reloaded when the underlying file has changed (`true` or `false`)
 `template_errors`:: How lookup errors in Python code in templates should be treated (`strict` or `lenient`)

== Security ==

 `csrf_protection`:: Whether forms should automatically be protected against Cross-Site Request Forgery (CSRF) attacks