Skip to main content

​
Containers not starting

If one or more containers fail to start, check the logs: 
docker compose logs <service>
Common causes:
  • Missing .env file — Copy the example and fill in your values: 
    cp .env.example .env
  • Port conflicts — Another service may already be using the required ports. Check with: 
    ss -tlnp | grep <port>
  • Missing emergency audio — Liquidsoap requires at least one fallback audio file in emergency-audio/. Add an MP3, FLAC, or WAV file to this directory.

​
No audio playing

1

Check Liquidsoap status

docker compose logs liquidsoap
Look for connection errors or missing source warnings.
2

Verify the stream mount point

Confirm your mount point is configured correctly in the streams configuration.
3

Test the Icecast endpoint

Open your Icecast URL directly in a browser or media player to confirm whether the stream is accessible.

​
Status panel not loading

  • Verify the status panel container is running: 
    docker compose ps status-panel
  • Check that the configured port is accessible and not blocked by your firewall.
  • Review the status panel logs for errors: 
    docker compose logs status-panel

​
Analytics not recording

  • Confirm the analytics container is running: 
    docker compose ps analytics
  • Check the analytics configuration for correct database connection settings.
  • Review the tracker logs: 
    docker compose logs analytics

​
High CPU or memory usage

  • Check which container is consuming resources: 
    docker stats
  • If Liquidsoap is using excessive CPU, reduce the number of concurrent streams or lower the encoding bitrate.
  • Consider allocating more resources to the host machine for production workloads.

​
Docker Compose errors

ErrorSolution
service "x" depends on undefined serviceVerify all service names in docker-compose.yml match exactly
port is already allocatedStop the conflicting service or change the port in .env
no matching manifest for linux/arm64Some images may not support ARM. Check for alternative images or build from source

​
Still stuck?

If none of the above resolves your issue:
  1. Search GitHub Issues for similar problems
  2. See the contact and help page for more support options