Configure your project¶
project_settings.py file is a Django settings module. You can override any
default Django/ICEkit settings or configure apps installed via
You will need to provide some basic information to configure your project.
You can do so with environment variables, or by editing the
All settings are optional, but you can provide:
BASE_SETTINGS_MODULEtells ICEkit to run in
EMAIL_HOST_USER, so ICEkit can send emails (only in
We recommend Mailgun, but any SMTP credentials will do.
developmode) so you can login as any user with the same password.
MEDIA_AWS_STORAGE_BUCKET_NAMEso ICEkit can store file uploads in Amazon S3.
The specified bucket should already exist, or the credentials provided should have permission to create buckets. This is especially important when deploying to ephemeral infrastructure, like Docker Cloud.
PGUSER, if you need to connect to provide credentials for your PostgreSQL database.
We recommend Amazon RDS, especially when deploying to ephemeral infrastructure, like Docker Cloud.
SENTRY_DSN, if you want to use Sentry for real-time error tracking.
SITE_NAME, so ICEkit knows how to generate redirects correctly and knows what to call your site.