configuration.rst

Configuration

We are fans of the 12factor approach and portable code so you can configure most of Saleor using just environment variables.

Environment variables

ALLOWED_HOSTS

Controls Django's allowed hosts setting. Defaults to localhost.

Separate multiple values with comma.

CACHE_URL or REDIS_URL

The URL of a cache database. Defaults to local process memory.

Redis is recommended. Heroku's Redis will export this setting automatically.

Example: redis://redis.example.com:6379/0

Warning

If you plan to use more than one WSGI process (or run more than one server/container) you need to use a shared cache server. Otherwise each process will have its own version of each user's session which will result in people being logged out and losing their shopping carts.

DATABASE_URL

Defaults to a local PostgreSQL instance. See :ref:`docker-compose` for how to get a local database running inside a Docker container.

Most Heroku databases will export this setting automatically.

Example: postgres://user:password@psql.example.com/database

DEBUG

Controls Django's debug mode. Defaults to True.

DEFAULT_FROM_EMAIL

Default email address to use for outgoing mail.

EMAIL_URL

The URL of the email gateway. Defaults to printing everything to the console.

Example: smtp://user:password@smtp.example.com:465/?ssl=True

INTERNAL_IPS

Controls Django's internal IPs setting. Defaults to 127.0.0.1.

Separate multiple values with comma.

SECRET_KEY

Controls Django's secret key setting.

MAX_CART_LINE_QUANTITY

Controls maximum number of items in one cart line. Defaults to 50.

STATIC_URL

Controls production assets' mount path. Defaults to /static/assets/.