Django is configured using a settings file which we store in ~/roundware-server/roundware/settings/ 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/ 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 server of email used for notifications
EMAIL_HOST_USER username of email used for notifications
EMAIL_HOST_PASSWORD password passwork of email used for notifications
DATABASES: NAME roundware name of the roundware database
DATABASES: USER round main database user
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.