## -*- coding: utf-8 -*- <%text>################################################################################ <%text>################################################################################ # Kallithea - config file generated with kallithea-config # # # # The %(here)s variable will be replaced with the parent directory of this file# <%text>################################################################################ <%text>################################################################################ [DEFAULT] <%text>################################################################################ <%text>## Email settings ## <%text>## ## <%text>## Refer to the documentation ("Email settings") for more details. ## <%text>## ## <%text>## It is recommended to use a valid sender address that passes access ## <%text>## validation and spam filtering in mail servers. ## <%text>################################################################################ <%text>## 'From' header for application emails. You can optionally add a name. <%text>## Default: #app_email_from = Kallithea <%text>## Examples: #app_email_from = Kallithea #app_email_from = kallithea-noreply@example.com <%text>## Subject prefix for application emails. <%text>## A space between this prefix and the real subject is automatically added. <%text>## Default: #email_prefix = <%text>## Example: #email_prefix = [Kallithea] <%text>## Recipients for error emails and fallback recipients of application mails. <%text>## Multiple addresses can be specified, comma-separated. <%text>## Only addresses are allowed, do not add any name part. <%text>## Default: #email_to = <%text>## Examples: #email_to = admin@example.com #email_to = admin@example.com,another_admin@example.com email_to = <%text>## 'From' header for error emails. You can optionally add a name. <%text>## Default: (none) <%text>## Examples: #error_email_from = Kallithea Errors #error_email_from = kallithea_errors@example.com error_email_from = <%text>## SMTP server settings <%text>## If specifying credentials, make sure to use secure connections. <%text>## Default: Send unencrypted unauthenticated mails to the specified smtp_server. <%text>## For "SSL", use smtp_use_ssl = true and smtp_port = 465. <%text>## For "STARTTLS", use smtp_use_tls = true and smtp_port = 587. smtp_server = #smtp_username = #smtp_password = smtp_port = #smtp_use_ssl = false #smtp_use_tls = false %if http_server != 'uwsgi': <%text>## Entry point for 'gearbox serve' [server:main] host = ${host} port = ${port} %if http_server == 'gearbox': <%text>## Gearbox default web server ## use = egg:gearbox#wsgiref <%text>## nr of worker threads to spawn threadpool_workers = 1 <%text>## max request before thread respawn threadpool_max_requests = 100 <%text>## option to use threads of process use_threadpool = true %elif http_server == 'gevent': <%text>## Gearbox gevent web server ## use = egg:gearbox#gevent %elif http_server == 'waitress': <%text>## WAITRESS ## use = egg:waitress#main <%text>## number of worker threads threads = 1 <%text>## MAX BODY SIZE 100GB max_request_body_size = 107374182400 <%text>## use poll instead of select, fixes fd limits, may not work on old <%text>## windows systems. #asyncore_use_poll = True %elif http_server == 'gunicorn': <%text>## GUNICORN ## use = egg:gunicorn#main <%text>## number of process workers. You must set `instance_id = *` when this option <%text>## is set to more than one worker workers = 4 <%text>## process name proc_name = kallithea <%text>## type of worker class, one of sync, eventlet, gevent, tornado <%text>## recommended for bigger setup is using of of other than sync one worker_class = sync max_requests = 1000 <%text>## amount of time a worker can handle request before it gets killed and <%text>## restarted timeout = 3600 %endif %else: <%text>## UWSGI ## <%text>## run with uwsgi --ini-paste-logged [uwsgi] socket = /tmp/uwsgi.sock master = true http = ${host}:${port} <%text>## set as daemon and redirect all output to file #daemonize = ./uwsgi_kallithea.log <%text>## master process PID pidfile = ./uwsgi_kallithea.pid <%text>## stats server with workers statistics, use uwsgitop <%text>## for monitoring, `uwsgitop 127.0.0.1:1717` stats = 127.0.0.1:1717 memory-report = true <%text>## log 5XX errors log-5xx = true <%text>## Set the socket listen queue size. listen = 128 <%text>## Gracefully Reload workers after the specified amount of managed requests <%text>## (avoid memory leaks). max-requests = 1000 <%text>## enable large buffers buffer-size = 65535 <%text>## socket and http timeouts ## http-timeout = 3600 socket-timeout = 3600 <%text>## Log requests slower than the specified number of milliseconds. log-slow = 10 <%text>## Exit if no app can be loaded. need-app = true <%text>## Set lazy mode (load apps in workers instead of master). lazy = true <%text>## scaling ## <%text>## set cheaper algorithm to use, if not set default will be used cheaper-algo = spare <%text>## minimum number of workers to keep at all times cheaper = 1 <%text>## number of workers to spawn at startup cheaper-initial = 1 <%text>## maximum number of workers that can be spawned workers = 4 <%text>## how many workers should be spawned at a time cheaper-step = 1 %endif <%text>## middleware for hosting the WSGI application under a URL prefix #[filter:proxy-prefix] #use = egg:PasteDeploy#prefix #prefix = / [app:main] use = egg:kallithea <%text>## enable proxy prefix middleware #filter-with = proxy-prefix full_stack = true static_files = true <%text>## Internationalization (see setup documentation for details) <%text>## By default, the language requested by the browser is used if available. #i18n.enable = false <%text>## Fallback language, empty for English (valid values are the names of subdirectories in kallithea/i18n): i18n.lang = cache_dir = %(here)s/data index_dir = %(here)s/data/index <%text>## perform a full repository scan on each server start, this should be <%text>## set to false after first startup, to allow faster server restarts. initial_repo_scan = false <%text>## uncomment and set this path to use archive download cache archive_cache_dir = %(here)s/tarballcache <%text>## change this to unique ID for security app_instance_uuid = ${uuid()} <%text>## cut off limit for large diffs (size in bytes) cut_off_limit = 256000 <%text>## force https in Kallithea, fixes https redirects, assumes it's always https force_https = false <%text>## use Strict-Transport-Security headers use_htsts = false <%text>## number of commits stats will parse on each iteration commit_parse_limit = 25 <%text>## path to git executable git_path = git <%text>## git rev filter option, --all is the default filter, if you need to <%text>## hide all refs in changelog switch this to --branches --tags #git_rev_filter = --branches --tags <%text>## RSS feed options rss_cut_off_limit = 256000 rss_items_per_page = 10 rss_include_diff = false <%text>## options for showing and identifying changesets show_sha_length = 12 show_revision_number = false <%text>## Canonical URL to use when creating full URLs in UI and texts. <%text>## Useful when the site is available under different names or protocols. <%text>## Defaults to what is provided in the WSGI environment. #canonical_url = https://kallithea.example.com/repos <%text>## gist URL alias, used to create nicer urls for gist. This should be an <%text>## url that does rewrites to _admin/gists/. <%text>## example: http://gist.example.com/{gistid}. Empty means use the internal <%text>## Kallithea url, ie. http[s]://kallithea.example.com/_admin/gists/ gist_alias_url = <%text>## white list of API enabled controllers. This allows to add list of <%text>## controllers to which access will be enabled by api_key. eg: to enable <%text>## api access to raw_files put `FilesController:raw`, to enable access to patches <%text>## add `ChangesetController:changeset_patch`. This list should be "," separated <%text>## Syntax is :. Check debug logs for generated names <%text>## Recommended settings below are commented out: api_access_controllers_whitelist = # ChangesetController:changeset_patch, # ChangesetController:changeset_raw, # FilesController:raw, # FilesController:archivefile <%text>## default encoding used to convert from and to unicode <%text>## can be also a comma separated list of encoding in case of mixed encodings default_encoding = utf8 <%text>## issue tracker for Kallithea (leave blank to disable, absent for default) #bugtracker = https://bitbucket.org/conservancy/kallithea/issues <%text>## issue tracking mapping for commits messages <%text>## comment out issue_pat, issue_server, issue_prefix to enable <%text>## pattern to get the issues from commit messages <%text>## default one used here is # with a regex passive group for `#` <%text>## {id} will be all groups matched from this pattern issue_pat = #(\d+) <%text>## server url to the issue, each {id} will be replaced with match <%text>## fetched from the regex and {repo} is replaced with full repository name <%text>## including groups {repo_name} is replaced with just name of repo issue_server_link = https://issues.example.com/{repo}/issue/{id} <%text>## prefix to add to link to indicate it's an url <%text>## #314 will be replaced by issue_prefix = # <%text>## issue_pat, issue_server_link, issue_prefix can have suffixes to specify <%text>## multiple patterns, to other issues server, wiki or others <%text>## below an example how to create a wiki pattern # wiki-some-id -> https://wiki.example.com/some-id #issue_pat_wiki = (?:wiki-)(.+) #issue_server_link_wiki = https://wiki.example.com/{id} #issue_prefix_wiki = WIKI- <%text>## alternative return HTTP header for failed authentication. Default HTTP <%text>## response is 401 HTTPUnauthorized. Currently Mercurial clients have trouble with <%text>## handling that. Set this variable to 403 to return HTTPForbidden auth_ret_code = <%text>## locking return code. When repository is locked return this HTTP code. 2XX <%text>## codes don't break the transactions while 4XX codes do lock_ret_code = 423 <%text>## allows to change the repository location in settings page allow_repo_location_change = True <%text>## allows to setup custom hooks in settings page allow_custom_hooks_settings = True <%text>## extra extensions for indexing, space separated and without the leading '.'. # index.extensions = # gemfile # lock <%text>## extra filenames for indexing, space separated # index.filenames = # .dockerignore # .editorconfig # INSTALL # CHANGELOG <%text>#################################### <%text>### CELERY CONFIG #### <%text>#################################### use_celery = false <%text>## Example: connect to the virtual host 'rabbitmqhost' on localhost as rabbitmq: broker.url = amqp://rabbitmq:qewqew@localhost:5672/rabbitmqhost celery.imports = kallithea.lib.celerylib.tasks celery.accept.content = pickle celery.result.backend = amqp celery.result.dburi = amqp:// celery.result.serialier = json #celery.send.task.error.emails = true #celery.amqp.task.result.expires = 18000 celeryd.concurrency = 2 celeryd.max.tasks.per.child = 1 <%text>## If true, tasks will never be sent to the queue, but executed locally instead. celery.always.eager = false <%text>#################################### <%text>### BEAKER CACHE #### <%text>#################################### beaker.cache.data_dir = %(here)s/data/cache/data beaker.cache.lock_dir = %(here)s/data/cache/lock beaker.cache.regions = short_term,long_term,sql_cache_short beaker.cache.short_term.type = memory beaker.cache.short_term.expire = 60 beaker.cache.short_term.key_length = 256 beaker.cache.long_term.type = memory beaker.cache.long_term.expire = 36000 beaker.cache.long_term.key_length = 256 beaker.cache.sql_cache_short.type = memory beaker.cache.sql_cache_short.expire = 10 beaker.cache.sql_cache_short.key_length = 256 <%text>#################################### <%text>### BEAKER SESSION #### <%text>#################################### <%text>## Name of session cookie. Should be unique for a given host and path, even when running <%text>## on different ports. Otherwise, cookie sessions will be shared and messed up. beaker.session.key = kallithea <%text>## Sessions should always only be accessible by the browser, not directly by JavaScript. beaker.session.httponly = true <%text>## Session lifetime. 2592000 seconds is 30 days. beaker.session.timeout = 2592000 <%text>## Server secret used with HMAC to ensure integrity of cookies. beaker.session.secret = ${uuid()} <%text>## Further, encrypt the data with AES. #beaker.session.encrypt_key = #beaker.session.validate_key = <%text>## Type of storage used for the session, current types are <%text>## dbm, file, memcached, database, and memory. <%text>## File system storage of session data. (default) #beaker.session.type = file <%text>## Cookie only, store all session data inside the cookie. Requires secure secrets. #beaker.session.type = cookie <%text>## Database storage of session data. #beaker.session.type = ext:database #beaker.session.sa.url = postgresql://postgres:qwe@localhost/kallithea #beaker.session.table_name = db_session %if error_aggregation_service == 'appenlight': <%text>############################ <%text>## ERROR HANDLING SYSTEMS ## <%text>############################ # Propagate email settings to ErrorReporter of TurboGears2 # You do not normally need to change these lines get trace_errors.error_email = email_to get trace_errors.smtp_server = smtp_server get trace_errors.smtp_port = smtp_port get trace_errors.from_address = error_email_from <%text>#################### <%text>### [appenlight] ### <%text>#################### <%text>## AppEnlight is tailored to work with Kallithea, see <%text>## http://appenlight.com for details how to obtain an account <%text>## you must install python package `appenlight_client` to make it work <%text>## appenlight enabled appenlight = false appenlight.server_url = https://api.appenlight.com appenlight.api_key = YOUR_API_KEY <%text>## TWEAK AMOUNT OF INFO SENT HERE <%text>## enables 404 error logging (default False) appenlight.report_404 = false <%text>## time in seconds after request is considered being slow (default 1) appenlight.slow_request_time = 1 <%text>## record slow requests in application <%text>## (needs to be enabled for slow datastore recording and time tracking) appenlight.slow_requests = true <%text>## enable hooking to application loggers #appenlight.logging = true <%text>## minimum log level for log capture #appenlight.logging.level = WARNING <%text>## send logs only from erroneous/slow requests <%text>## (saves API quota for intensive logging) appenlight.logging_on_error = false <%text>## list of additional keywords that should be grabbed from environ object <%text>## can be string with comma separated list of words in lowercase <%text>## (by default client will always send following info: <%text>## 'REMOTE_USER', 'REMOTE_ADDR', 'SERVER_NAME', 'CONTENT_TYPE' + all keys that <%text>## start with HTTP* this list be extended with additional keywords here appenlight.environ_keys_whitelist = <%text>## list of keywords that should be blanked from request object <%text>## can be string with comma separated list of words in lowercase <%text>## (by default client will always blank keys that contain following words <%text>## 'password', 'passwd', 'pwd', 'auth_tkt', 'secret', 'csrf' <%text>## this list be extended with additional keywords set here appenlight.request_keys_blacklist = <%text>## list of namespaces that should be ignores when gathering log entries <%text>## can be string with comma separated list of namespaces <%text>## (by default the client ignores own entries: appenlight_client.client) appenlight.log_namespace_blacklist = %elif error_aggregation_service == 'sentry': <%text>################ <%text>### [sentry] ### <%text>################ <%text>## sentry is a alternative open source error aggregator <%text>## you must install python packages `sentry` and `raven` to enable sentry.dsn = YOUR_DNS sentry.servers = sentry.name = sentry.key = sentry.public_key = sentry.secret_key = sentry.project = sentry.site = sentry.include_paths = sentry.exclude_paths = %endif <%text>################################################################################ <%text>## WARNING: *DEBUG MODE MUST BE OFF IN A PRODUCTION ENVIRONMENT* ## <%text>## Debug mode will enable the interactive debugging tool, allowing ANYONE to ## <%text>## execute malicious code after an exception is raised. ## <%text>################################################################################ debug = false <%text>################################## <%text>### LOGVIEW CONFIG ### <%text>################################## logview.sqlalchemy = #faa logview.pylons.templating = #bfb logview.pylons.util = #eee <%text>######################################################### <%text>### DB CONFIGS - EACH DB WILL HAVE IT'S OWN CONFIG ### <%text>######################################################### %if database_engine == 'sqlite': # SQLITE [default] sqlalchemy.url = sqlite:///%(here)s/kallithea.db?timeout=60 %elif database_engine == 'postgres': # POSTGRESQL sqlalchemy.url = postgresql://user:pass@localhost/kallithea %elif database_engine == 'mysql': # MySQL sqlalchemy.url = mysql://user:pass@localhost/kallithea?charset=utf8 %endif # see sqlalchemy docs for others sqlalchemy.pool_recycle = 3600 <%text>################################ <%text>### ALEMBIC CONFIGURATION #### <%text>################################ [alembic] script_location = kallithea:alembic <%text>################################ <%text>### LOGGING CONFIGURATION #### <%text>################################ [loggers] keys = root, routes, kallithea, sqlalchemy, tg, gearbox, beaker, templates, whoosh_indexer, werkzeug, backlash [handlers] keys = console, console_sql [formatters] keys = generic, color_formatter, color_formatter_sql <%text>############# <%text>## LOGGERS ## <%text>############# [logger_root] level = NOTSET handlers = console [logger_routes] level = WARN handlers = qualname = routes.middleware <%text>## "level = DEBUG" logs the route matched and routing variables. propagate = 1 [logger_beaker] level = WARN handlers = qualname = beaker.container propagate = 1 [logger_templates] level = WARN handlers = qualname = pylons.templating propagate = 1 [logger_kallithea] level = WARN handlers = qualname = kallithea propagate = 1 [logger_tg] level = WARN handlers = qualname = tg propagate = 1 [logger_gearbox] level = WARN handlers = qualname = gearbox propagate = 1 [logger_sqlalchemy] level = WARN handlers = console_sql qualname = sqlalchemy.engine propagate = 0 [logger_whoosh_indexer] level = WARN handlers = qualname = whoosh_indexer propagate = 1 [logger_werkzeug] level = WARN handlers = qualname = werkzeug propagate = 1 [logger_backlash] level = WARN handlers = qualname = backlash propagate = 1 <%text>############## <%text>## HANDLERS ## <%text>############## [handler_console] class = StreamHandler args = (sys.stderr,) formatter = generic [handler_console_sql] class = StreamHandler args = (sys.stderr,) formatter = generic <%text>################ <%text>## FORMATTERS ## <%text>################ [formatter_generic] format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s datefmt = %Y-%m-%d %H:%M:%S [formatter_color_formatter] class = kallithea.lib.colored_formatter.ColorFormatter format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s datefmt = %Y-%m-%d %H:%M:%S [formatter_color_formatter_sql] class = kallithea.lib.colored_formatter.ColorFormatterSql format = %(asctime)s.%(msecs)03d %(levelname)-5.5s [%(name)s] %(message)s datefmt = %Y-%m-%d %H:%M:%S