Running SM2 with Docker - ymatto/Station-Manager-2 GitHub Wiki

While Station Manager 2 can be configured for use with locally-installed Liquidsoap and Icecast, the easiest and best way to use Station Manager is with Docker so it can rely on known-good and cross-platform access to Liquidsoap and Icecast.

To create a station in Station Manager 2, you will put all of your configuration folders in their own folder along with a docker compose file that will handle the rest. This repo includes an example/ folder containing a simple and fully-configured example netradio station that you can start up with a single docker command.

In example/, you'll find a docker-compose.yml that includes the right Liquidsoap and Icecast docker containers, configures shared ports for Icecast broadcast and Station Manager's telenet server, and shared volumes that Station Manager will need to work.

You'll also find a set of example json configuration file for Station Manager, and an example icecast.xml for Icecast broadcast, which can then be modified to suit.

To start up a station, you'll run the docker compose within the station's folder (like example/).

For normal production deployment, this command will use the default docker-compose.yml and run the station in the background:

docker compose up -d

For debugging, this command will do a single run in the foreground:

docker compose up --abort-on-container-exit

Or if you want to create an alternative docker compose file for testing, you can use this:

docker compose -f test-docker-compose.yml up --abort-on-container-exit

The included Text-To-Speech TTS_server.rb script can also be optionally used to enable automated voice synthesis for your station's DJ. This script must be run separately from the core docker compose setup. To use the default config (which is used for voice announcements in the example staation), run TTS_server.rb within its folder. (Read more about the TTS Server here.)

That's it - you're up and running!

To listen, using the default example configuration, point your netradio player at http://localhost:8000/sm2_test and you'll hear some example tunes playing (courtesy of the awesome dudes at the creative commons-licensed Dusted Wax Kingdom label).

Or you can pull up the Icecast broadcast status page at http://localhost:8000/status to see stats, get playlist links, etc.

Now that you've got your radio station equivalent of "hello world" (or maybe "good mooooorning, vietnam"), you can move on to configuring your SM2 station.