Configuration

Config options are mostly passed to Indigo as environment variables. These are the options you can set:

  • AWS_ACCESS_KEY_ID

    Required for production. The AWS access key ID for the account with write-access to the S3 bucket used for storing attachments.

  • AWS_SECRET_ACCESS_KEY

    Required for production. The AWS secret access key for the account with write-access to the S3 bucket used for storing attachments.

  • AWS_S3_BUCKET

    Required for production. The name of the S3 bucket for storing attachments.

  • AWS_S3_HOST

    The regional S3 endpoint to use. Optional. Default: s3-eu-west-1.amazonaws.com

  • DATABASE_URL

    Required. The URL of the database to use

  • DJANGO_DEBUG

    The Django DEBUG setting. Everything other than true means False. This should always be false in production. Default: true

  • DJANGO_DEFAULT_FROM_EMAIL

    The Django DEFAULT_FROM_EMAIL setting: who do emails come from? Uses SUPPORT_EMAIL by default.

  • DJANGO_EMAIL_HOST

    The Django EMAIL_HOST setting. The SMTP host through which to send user emails such as password resets.

  • DJANGO_EMAIL_HOST_PASSWORD

    The Django EMAIL_HOST_PASSWORD setting. The SMTP password.

  • DJANGO_EMAIL_HOST_PORT

    The Django EMAIL_HOST_PORT setting. The SMTP port (default: 25).

  • DJANGO_EMAIL_HOST_USER

    The Django EMAIL_HOST_USER setting. The SMTP username.

  • DJANGO_SECRET_KEY

    Required if DJANGO_DEBUG is not true. The Django SECRET_KEY setting. In production you should use a random (and secret) string.

  • GOOGLE_ANALYTICS_ID

    Google Analytics ID for website tracking. Only used when DEBUG is False.

  • SUPPORT_EMAIL

    Required Email address users can email for help.

  • INDIGO.EMAIL_FAIL_SILENTLY

    Should email sending fail silently?

  • INDIGO.GSHEETS_API_CREDS

    JSON of Google Sheets API credentials token details, if you want Indigo to be able to talk to Google Sheets directly. Otherwise, Indigo will use CSV export and the Google Sheet will need to be publicly accessible.

    For details on setting up Google Sheets for API access, see https://medium.com/@denisluiz/python-with-google-sheets-service-account-step-by-step-8f74c26ed28e

  • INDIGO.NOTIFICATION_EMAILS_BACKGROUND

    Should notification emails be sent asynchronously in the background? Default is False. See django-background-tasks documentation.

Authentication

Indigo uses django-allauth for user authentication and social accounts, configuration is as per the django-allauth documentation.

Social Accounts

By default, Indigo doesn’t have any social account authentication enabled. To enable a social provider, follow the documentation for django-allauth. Namely, you’ll need to:

  1. Include the account provider in INSTALLED_APPS:

    INSTALLED_APPS = INSTALLED_APPS + (‘allauth.socialaccount.providers.google’,)

  2. Get the appropriate client and secret keys from the provider, and create a social app in the admin interface.