Settings
Django is configured using a settings file which we store in ~/roundware-server/roundware/settings/common.py. We have consolidated Roundware-specific settings into this file as well to keep them all together. It is highly recommended that you create a local settings file ~/roundware-server/roundware/settings/local.py in which to store settings specific to your environment, passwords, etc.
Here is a list of the most critical settings parameters that are specific to Roundware:
Roundware-specific Settings
| Parameter | Default Value | Notes |
|---|---|---|
| ICECAST_PORT | 8000 | set to port which Icecast uses to broadcast streams; must correspond to the listen-socket port in /etc/icecast2/icecast.xml |
| ICECAST_HOST | localhost | set to host address where Icecast streams will be accessible to the RW clients |
| ICECAST_USERNAME | admin | must correspond to username setup in /etc/icecast2/icecast.xml |
| ICECAST_PASSWORD | roundice | must correspond to password setup in /etc/icecast2/icecast.xml |
| MASTER_VOLUME | 3.0 | overall stream volume attenuation |
| HEARTBEAT_TIMEOUT | 200 | number of seconds after which a stream will be destroyed and cleaned up if it hasn't received a heartbeat or other message |
| EXTERNAL_HOST_NAME_ WITHOUT_PORT | localhost | host for client access to Icecast streams |
| DEMO_STREAM_CPU_LIMIT | 50.0 | When cpu usage on machine rises above this value, new clients receive the demo stream instead of a new unique stream. This helps prevent performance degradation in times of significant usage. |
| ALLOWED_AUDIO_MIME_TYPES | 'audio/x-wav', 'audio/wav', 'audio/mpeg', 'audio/mp4a-latm', 'audio/x-caf', 'audio/mp3' | audio file types allowed for upload |
| ALLOWED_IMAGE_MIME_TYPES | 'image/jpeg', 'image/gif', 'image/png', 'image/pjpeg' | image file types allowed for upload |
| ALLOWED_TEXT_MIME_TYPES | 'text/plain', 'text/html', 'application/xml' | text file types allowed for upload |
| DEFAULT_SESSION_ID | -10 | session_id assigned to any assets uploaded via the admin interface. Session with this id must exist in the session table. |
| ANONYMOUS_USER_ID | 1 | id of anonymous user for use by Django Guardian |
| EMAIL_HOST | smtp.example.com | SMTP server of email used for notifications |
| EMAIL_HOST_USER | email@example.com | username of email used for notifications |
| EMAIL_HOST_PASSWORD | password | passwork of email used for notifications |
| EMAIL_PORT | 587 | |
| EMAIL_USE_TLS | True | |
| DATABASES: NAME | roundware | name of the roundware database |
| DATABASES: USER | round | main database user |
| DATABASES: PASSWORD | round | |
| ALLOWED_HOSTS | * | hosts from which users can login; should be restricted on production systems |
Django Settings
Other settings found in the default settings file are primarily Django-specific and can be adjusted as needed, referring to the Django documentation.