asteroid/docker/docker-streaming.org

Asteroid Radio - Docker Streaming Setup

• Quick Start
• What's Included
• Stream URLs
• Admin Interfaces
• Manual Commands
  • Start Services
  • Stop Services
  • View Logs
  • Restart Services
  • Control Liquidsoap via Telnet
• File Structure
• Configuration
  • Adding Music
  • Customizing Streams
  • Icecast Configuration
  • Docker Image
• Troubleshooting
  • Services won't start
  • No audio in stream
  • Can't connect to stream
  • Permission issues
• Integration with Asteroid Web Interface
• Windows/WSL Notes
• Production Deployment

This setup provides a complete streaming solution using Docker with Liquidsoap and Icecast2.

Quick Start

1. Ensure you have music files in the ./music/ directory

2. Start the streaming services:

   ./start-streaming.sh

What's Included

• Icecast2: Streaming server (port 8000)
• Liquidsoap: Audio processing and streaming client
• Automatic playlist: Randomized playback from ./music/ directory
• Multiple stream qualities: 128kbps and 64kbps MP3 streams
• Audio processing: Normalization, crossfading, metadata handling

Stream URLs

• High Quality (128kbps): http://localhost:8000/asteroid.mp3
• Low Quality (64kbps): http://localhost:8000/asteroid-low.mp3

Admin Interfaces

• Icecast Admin: http://localhost:8000/admin/

  • Username: admin
  • Password: asteroid_admin_2024

• Asteroid Web Interface: http://localhost:8080/asteroid/

  • Username: admin
  • Password: asteroid123

Manual Commands

Start Services

docker compose up -d

Stop Services

docker compose down

View Logs

# All services
docker compose logs -f

# Specific service
docker compose logs -f liquidsoap
docker compose logs -f icecast

Restart Services

docker compose restart

Control Liquidsoap via Telnet

telnet localhost 1234

Common telnet commands:

• help - Show available commands
• request.queue - Show current queue
• request.push /path/to/file.mp3 - Add specific file to queue
• var.get volume - Get current volume
• var.set volume 0.8 - Set volume (0.0 to 1.0)

File Structure

asteroid/docker/
├── docker-compose.yml          # Docker orchestration
├── Dockerfile.liquidsoap       # Simple Dockerfile using official image
├── icecast.xml                # Icecast2 configuration
├── asteroid-radio-docker.liq   # Liquidsoap script for Docker
├── start.sh                   # Simple start script
├── stop.sh                    # Simple stop script
├── docker-streaming.org        # This documentation
└── setup-complete.org         # Setup summary

Configuration

Adding Music

1. Place music files (MP3, FLAC, OGG, WAV) in your music directory
2. Update docker-compose.yml to mount your music directory
3. Liquidsoap will automatically detect and play them
4. Playlist reloads every hour or when files change

Customizing Streams

Edit asteroid-radio-docker.liq to:

• Change bitrates
• Add more stream outputs
• Modify audio processing
• Adjust crossfade settings

Icecast Configuration

Edit icecast.xml to:

• Change passwords
• Modify listener limits
• Add more mount points
• Configure logging

Docker Image

Uses official savonet/liquidsoap:latest image:

• Pre-built with all audio codecs (MP3, FLAC, OGG, WAV, etc.)
• System agnostic - works on any Docker-capable system
• Maintained by the Liquidsoap team
• Fast builds - no compilation required

Troubleshooting

Services won't start

# Check Docker status
docker info

# Check service logs
docker compose logs

No audio in stream

1. Verify music files exist in ./music/
2. Check Liquidsoap logs: docker compose logs liquidsoap
3. Ensure file formats are supported (MP3, FLAC, OGG, WAV)

Can't connect to stream

1. Check if Icecast is running: docker compose ps
2. Verify port 8000 is not blocked by firewall
3. Check Icecast logs: docker compose logs icecast

Permission issues

# Fix file permissions
chmod +x start-streaming.sh
chmod 644 icecast.xml asteroid-radio-docker.liq

Integration with Asteroid Web Interface

The Asteroid web application can be updated to show the correct streaming status by checking if the Docker services are running. The admin dashboard will show:

• Liquidsoap Status: 🟢 Running (when Docker container is up)
• Icecast Status: 🟢 Running (when Docker container is up)

Windows/WSL Notes

This setup works in WSL (Windows Subsystem for Linux) with Docker Desktop:

1. Ensure Docker Desktop is running
2. Use WSL2 backend for better performance
3. Access streams via localhost from Windows browsers
4. File paths should use Linux format in WSL

Production Deployment

For production use:

1. Change all default passwords in icecast.xml
2. Use environment variables for sensitive configuration
3. Set up proper SSL/TLS certificates
4. Configure firewall rules appropriately
5. Consider using Docker secrets for password management