Finally! - A multi-container deployment of the Airtime Radio Broadcast Server, PostgreSQL, & RabbitMQ
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

"Airtime" Multi-container Docker Setup.

###This project is no longer maintained as the upstream open-source project is now stale - Instead please see my Libretime container which is still actively maintained!


This is a multi-container Docker build of the Sourcefabric Airtime Radio Broadcast Software.

It's an aim to run the environment ready for production, with common media directories, database files etc mapped into the container(s) so data is persisted between rebuilds of the application.

It was loosely based on @okvic77's doker build, however I've rewritten all of it during the phase of 'splitting out' the containers, and troubleshooting / trying to get the environment running for a proper dockerised "production" deployment - Thanks Okvic for the inspiration however :)

UI Screenshot

Configuration Passing


The project consists of three main containers/components:

  • airtime-core - This is the main Airtime container, running the latest stable build distributed by Sourcefabric (as of September 2018) - Based on Ubuntu Trusty.
  • airtime-rabbitmq - A seperated RabbitMQ container based on Alpine Linux.
  • airtime-postgres - The database engine behind Airtime - It's also an Alpine Linux build in an attempt to be as 'lean and mean' as possible when it comes to system resources...


You will want to edit the docker-compose.yml file and change some of the mappings to suit your needs. If you're new to docker you should probably just change the /localmusic:/external-media:ro line to the directory on your Linux server where your media resides (Just replace /localmusic with the path to your media).

You will also want to configure icecast.xml to suit your needs - (Don't leave the passwords as the default if you're exposing this to the internet).

Standing up:

It's pretty straightforward, just clone down the sources and stand up the container like so:

# Clone down sources
git clone

# Stand up the container
docker-compose up -d --build

NOTE: When running for the first time, the airtime-core container will run some 'boostrap' scripts. This will take 30-60 seconds (after standing up the containers) BEFORE you will be able to fully access airtime.

You can monitor the progress of the bootstrap process by running: docker logs -f airtime-core.

Once the containers have been stood up you should be able to access the project directly in your browser...


Just go to http://server-ip:8882/ (remove port 8882 if you mapped 80:80 in your docker-compose file)...

  • Default Username: admin
  • Default Password: admin

If you need to check the status of any services you may also do so by going to:

Have fun!


Things to note / hack fixes:

  • There seems to be a bug in the current build of Airtime where if you run Postgres on another host the web/ui fails to log in (without any logs/errors showing anywhere)... After much pain trying to get this running "properly", the quick and simple fix has been to use a TCP proxy, that just proxies the PostgreSQL port:5432 to the actual dedicated postgres container.

  • Icecast can't really run in it's own dedicated container because Airtime writes its config - This could be fixed my mapping the config files from one container into the other, but how far do we want to go here... For now, there's going to be no harm running it in the main airtime-core container as it uses minimal resources anyway.

Deploying on the internet?

You will need to setup port forwarding for TCP:8000 (Icecast server) and perhaps to your web interface...

You might want to use something like Caddy to proxy pass to Apache with an automatic signed SSL certificate thanks to Lets Encrypt...