Application settings¶
Here is a detailed list of all the environment variables which can be used to configure your Callico instance.
| Setting name | Description | Required | Values |
|---|---|---|---|
| DEBUG | Set the platform in production or development mode. It is insecure to run a public instance in development mode. | ✅ | true or false |
| DATABASE_URL | Credentials to connect to the PostgreSQL database. | ✅ | postgres://user:password@host:port/dbname |
| SECRET_KEY | Random string used to build securely authentication cookies. Must be unique per instance. | ✅ | randomString1234 |
| ALLOWED_HOSTS | List of public hostnames where HTTP requests come from. Any request received from an hostname not listed here will be rejected. When using multiple values, use a comma to separate them. | ✅ | callico.company.com |
| CORS_ALLOWED_ORIGINS | List of public hostnames where Javascript requests come from. Beware this list must have http(s) scheme before the hostname. When using multiple values, use a comma to separate them. | ✅ | https://callico.company.com |
| CSRF_TRUSTED_ORIGINS | List of public hostnames where form publication requests come from. Beware this list must have http(s) scheme before the hostname. When using multiple values, use a comma to separate them. | ✅ | https://callico.company.com |
| REDIS_URL | URL used to reach the Redis server for asynchronous tasks. | ✅ | redis://host:port/dbname |
| INSTANCE_URL | Public hostname used to host the instance. It is mainly used to build urls in emails. | ✅ | callico.company.com |
| SIGNUP_ENABLED | Specify if guests are allowed to create an account on the Callico instance. By default, signups are disabled. | true or false |
|
| EMAIL_URL | Credentials to send emails with the application. An SMTP email account is required to send Callico emails such as "Forget password", "Daily statistics", etc. | smtp://user:password@host:port |
|
| DEFAULT_FROM_EMAIL | The email address which will be used to send the emails. | noreply-callico@company.com |
|
| SENTRY_DSN | Sentry private DSN used to publish Python exceptions. | https://sentry.io/... |
|
| SENTRY_FRONTEND_DSN | Sentry private DSN used to publish Javascript exceptions. | https://sentry.io/... |
|
| STORAGE_BUCKET_NAME | AWS S3-compatible bucket name where the media files will be stored. | ✅ | callico-bucket |
| AWS_ACCESS_KEY_ID | AWS S3-compatible access key to read and write on the media files bucket. | ✅ | accessKey |
| AWS_SECRET_ACCESS_KEY | AWS S3-compatible secret access key to read and write on the media files bucket. | ✅ | secretKey1234 |
| STORAGE_ENDPOINT_URL | AWS S3-compatible endpoint url. By default, official Amazon S3 service will be used. | https://storage.company.com |
|
| STORAGE_SSL_CA_PATH | AWS S3-compatible SSL Certificate Authority to validate the endpoint. Only used if the provider use self-signed certificates. | /path/to/ca.crt |
|
| STORAGE_LOCATION | AWS S3-compatible optional prefix for every file that will be managed by Callico. Only useful if the bucket is shared with other applications. | company/project |
|
| PROJECT_CREATION_ALLOWED | Specify if all authenticated users are allowed to create projects on the Callico instance. By default, project creation is reserved to staff users. | true or false |