Configuration

The defaults described are the defaults in code and not necessarily what is in the default orlo.ini.

[main]

debug_mode:true or false. Default false. Enables Flask’s debug mode.
time_format:A strftime string. Default %Y-%m-%dT%H:%M:%SZ.
time_zone:Local time zone, as understood by pytz. Internally, all timestamps are stored in UTC. The timestamp is interpreted by Arrow when timestamps are given by the user (e.g. on recording a release), this setting merely reflects what time zone is given back to GET requests. Default UTC.
base_url:The external url which points to your web app. Required for callbacks. Default http://localhost:8080.

[security]

enabled:true or false. Enables security.
passwd_file:Path to a htpasswd file to use for authentication.
secret_key:A secret key to use for token encryption. Default change_me. If security is enabled and this is still set to change_me, Orlo will refuse to start.
token_ttl:The length of times that tokens should live for in seconds. Tokens automatically expire after this. Default 3600.
ldap_server:Ldap server to use for ldap requests. Default localhost .localdomain
ldap_port:Ldap port to use for ldap requests. Default 389.
user_base_dn:Ldap dn in which to search for users. Default ou=people, ou=example,ou=test

[db]

uri:Database uri for SQLAlchemy. See Flask-SQLAlchemy docs for details. Default postgres://orlo:password@localhost:5432/orlo
echo_queries:Whether or not to echo sql queries to log. Default false.
pool_size:Pool size for database connections. Default 50. This default errs on the high side and could probably be reduced for most installations.

[flask]

strict_slashes:true or false. Default false. By default, Werkzeug (what Flask uses underneath), will automatically “handle” trailing slashes, with the result that /foo/ and /foo are the same url. This disables that behaviour. It is recommended that you leave this set to false. See the Werkzeug documentation for more information.
propagate_exceptions:
 true or false. Default true. Sets ‘PROPAGATE_EXCEPTIONS` in Flask. See Flask documentation for details.
debug:Enable Flask debug mode. Default false. This is a security risk, enable with care.

[gunicorn]

workers:Number of gunicorn workers to start (for handling requests).
bind:Address:port to bind to. Default 127.0.0.1:8080.

[logging]

level:Logging level, valid values debug, info, warning, error. Default info.
directory:Log directory to store logs in, if logging is enabled.
format:Output format of logs. This should be a string which is accepted by Python’s logging.Formatter. See Formatter Objects and LogRecord Attributes for more information. Default %(asctime)s [%(name)s] %(levelname)s %(module)s:%(funcName)s:%(lineno)d - %(message)s