umonkey/ardj repository overview

ardj is an artificial DJ software which lets you easily run an internet radio with multiple playlists for different days and hours, rate tracks, add jingles and pre-rolls, etc.

This container includes supervisord, icecast2, ices0, uwsgi, nginx, cron and a custom background task executor.

All source code is available at Bitbucket, repo umonkey/ardj⁠.

PS. All in one container, yes. The purpose of this container is to simplify running a radio station; you will hardly ever need to scale anything other than bandwidth or disk space. Orchestration is an overkill for this task. If you still think that it's necessary, then contribute!

⁠Running

1. Create a folder where you want to store music files and ardj runtime data. Or a volume. Example: $ docker volume create ardj
2. Run the container: $ docker run -p 8100:8000 -p 8180:80 -v ardj:/home/ardj -t umonkey/ardj:latest

When the container runs, the following resources are available:

• MP3 stream: http://localhost:8100/live.mp3⁠
• Management console: http://localhost:8180/⁠

There is some built-in music for you to test it.

Normally you'd have a Nginx reverse proxy in front of this all, with access control, SSL etc.

⁠Further improvements

For a busy station you probably want to replace SQLite with MySQL. For that you'd need to install MySQL on the docker host, or run a different container with a MySQL server. Edit config.yaml to change the connection options.

⁠More information

• Source code⁠
• Home page⁠ (it's in Russian, sorry)