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.
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 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 whitespace.

SECRET_KEY
Controls Django’s secret key setting.
MAX_CART_LINE_QUANTITY
Controls maximum number of items in one cart line. Defaults to 50