.. highlight:: ini .. _`config`: Configuration file ================== Pretix reads its configuration from a configuration file. It tries to find this file at the following locations. It will try to read the file from the specified paths in the following order. The file that is found *last* will override the settings from the files found before. 1. ``/etc/pretix/pretix.cfg`` 2. ``~/.pretix.cfg`` 3. ``pretix.cfg`` in the current working directory The file is expected to be in the INI format as specified in the `Python documentation`_. The config file may contain the following sections (all settings are optional and have default values). pretix settings --------------- Example:: [pretix] instance_name=pretix.de url=http://localhost currency=EUR cookiedomain=.pretix.de securecookie=on datadir=/data plugins_default=pretix.plugins.sendmail,pretix.plugins.statistics ``instance_name`` The name of this installation. Default: ``pretix.de`` ``url`` The installation's full URL, without a trailing slash. ``currency`` The default currency as a three-letter code. Defaults to ``EUR``. ``cookiedomain`` The domain to be used for session cookies, csrf protection cookies and locale cookies. Empty by default. ``securecookie`` Set the ``secure`` and ``httponly`` flags on session cookies. Off by default. ``datadir`` The local path to a data directory that will be used for storing user uploads and similar data. Defaults to thea value of the environment variable ``DATA_DIR`` or ``data``. ``plugins_default`` A comma-separated list of plugins that are enabled by default for all new events. Defaults to ``pretix.plugins.sendmail,pretix.plugins.statistics``. Locale settings --------------- Example:: [locale] default=de timezone=Europe/Berlin ``default`` The system's default locale. Default: ``en`` ``timezone`` The system's default timezone as a ``pytz`` name. Default: ``UTC`` Database settings ----------------- Example:: [database] backend=mysql name=pretix user=pretix password=abcd host=localhost port=3306 ``backend`` One of ``mysql``, ``sqlite3``, ``oracle`` and ``postgresql_psycopg2``. Default: ``sqlite3``. If you use MySQL, be sure to create your database using ``CREATE DATABASE CHARACTER SET utf8;``. Otherwise, Unicode support will not properly work. ``name`` The database's name. Default: ``db.sqlite3``. ``user``, ``password``, ``host``, ``port`` Connection details for the database connection. Empty by default. URLs ---- Example:: [urls] media=/media/ static=/media/ ``media`` The URL to be used to serve user-uploaded content. You should not need to modify this. Default: ``/media/`` ``static`` The URL to be used to serve static files. You should not need to modify this. Default: ``/static/`` Email ----- Example:: [mail] from=hello@localhost host=127.0.0.71 user=pretix password=foobar port=1025 tls=on ssl=off ``host``, ``port`` The SMTP Host to connect to. Defaults to ``localhost`` and ``25``. ``user``, ``password`` The SMTP user data to use for the connection. Empty by default. ``from`` The email address to set as ``From`` header in outgoing emails by the system. Default: ``pretix@localhost`` ``tls``, ``ssl`` Use STARTTLS or SSL for the SMTP connection. Off by default. ``admins`` Comma-separated list of e-mail addresses that should receive a report about every error 500 thrown by pretix. Django settings --------------- Example:: [django] hosts=localhost secret=j1kjps5a5&4ilpn912s7a1!e2h!duz^i3&idu@_907s$wrz@x- debug=off ``hosts`` Comma-seperated list of allowed host names for this installation. Default: ``localhost`` ``secret`` The secret to be used by Django for signing and verification purposes. If this setting is not provided, pretix will generate a random secret on the first start and store it in the filesystem for later usage. ``debug`` Whether or not to run in debug mode. Default is ``False``. .. WARNING:: Never set this to ``True`` in production! Memcached --------- You can use an existing memcached server as pretix's caching backend:: [memcached] location=127.0.0.1:11211 ``location`` The location of memcached, either a host:port combination or a socket file. If no memcached is configures, pretix will use Django's built-in local-memory caching method. Redis ----- If a redis server is configured, pretix can use it for locking, caching and session storage to speed up various operations:: [redis] location=redis://127.0.0.1:6379/1 sessions=false ``location`` The location of memcached, as an URL of the form ``redis://[:password]@localhost:6379/0`` or ``unix://[:password]@/path/to/socket.sock?db=0`` ``session`` When this is set to true, redis will be used as the session storage. If no redis is configured, pretix will store sessions and locks in the database. If memcached is configured, memcached will be used for caching instead of redis. Celery task queue ----------------- For processing long-running tasks asynchronously, pretix needs help of the celery task queue. For communicating between the web server and the task workers in both direction, a messaging queue and a result backend is needed. You can use a redis database for both directions, or an AMQP server (e.h. RabbitMQ) as a broker and redis or your database as a result backend:: [celery] broker=amqp://guest:guest@localhost:5672// backend=redis://localhost/0 RabbitMQ might be the better choice if you have a complex, multi-server, high-performance setup, but as you already should have a redis instance ready for session and lock storage, we recommend redis for convenience. See the `Celery documentation`_ for more details. .. _Python documentation: https://docs.python.org/3/library/configparser.html?highlight=configparser#supported-ini-file-structure .. _Celery documentation: http://docs.celeryproject.org/en/latest/configuration.html