MediaCP Manual
    1. Getting Started
    2. Sales Questions
    3. Frequently Asked Questions
    4. Transcoder System Benchmarks
    5. Start an audio streaming business
    1. Change account currency
    2. Product Licensing
    1. Introduction
    2. Installation & Upgrade
      1. System Requirements
      2. Versions & Releases
      3. Installation
      4. Upgrading
      5. Streaming Servers
        1. Nginx-Rtmp Video Server
        2. Flussonic Media Server
        3. Wowza Streaming Engine
      6. SSL Certificates
    3. Billing Integration
      1. WHMCS Integration Guide
    4. Migrate from other software
      1. Migrate from Centovacast
    5. Backup & Restoration
      1. Backup MediaCP
      2. Restore MediaCP
      3. Transfer to another server
    6. Administration
      1. Custom Web Service Configurations
      2. Reset Admin Password
      3. Port 80 / 443 Proxy
      4. MediaCP System Commands
      5. Change MediaCP domain name
      6. Move media to another hard disk
      7. Secure your server
    7. Scaling
      1. Scale with Wowza and CloudFront CDN
      2. Nginx-Rtmp with CloudFront CDN
    8. Troubleshooting
      1. Grant access to support team
      2. Troubleshooting Wowza Streaming Engine
      3. FTP Troubleshooting
      4. MySQL Database Troubleshooting
      5. Reporting Troubleshooting
      6. Troubleshooting Liquidsoap AutoDJ
    1. Introduction
    2. Administrators Dashboard
    3. System Configuration
      1. General
      2. Services
      3. Video Players
      4. Albums
      5. Email
      6. Plugins
      7. Statistics
      8. Backups
      9. Custom HTML
      10. Misc
    4. Customer Accounts
      1. Managing existing Customers
      2. Create a new Customer
      3. Deleting a Customer
      4. Login as another Customer
      5. Send email to Customer
      6. Reset Customer Password
    5. Reseller Accounts
      1. Reseller Plans
      2. Create a Reseller Account
    6. Media Services
      1. Creating a Media Service
      2. Deleting a Media Service
    7. Announcements
      1. Managing Announcements
      2. Creating Announcement
      3. Deleting Announcement
    8. Statistics
    9. Software Health
    10. Software Updates
    11. Email Templates
    12. API
    1. API Documentation
    2. Custom Domain Names
    3. Shoutcast 2 Admin Guide
    4. Wowza and Flussonic on same system
    5. Submit a feature request
    6. Wowza Custom Properties
    1. Shoutcast 2 Live Broadcasting
    2. DJ Priorities
    3. HTML5 Audio Player
    4. Broadcasting with AutoDJ
    5. Shoutcast 2 Premium
    6. Mount Points
    1. Ondemand Video Streaming
    2. Getting started with video streaming
    3. Relay & IP Camera
Troubleshooting Liquidsoap AutoDJ

Last updated 6 hours ago

AutoDJ (liquidsoap) will not start

Here are some common reasons and solutions for AutoDJ failing to start.

1. Liquidsoap installation or update might have failed

You can check if liquidsoap is installed and operating normally by running the following as root user via SSH:

/usr/local/mediacp/liquidsoap/bin/liquidsoap --version

You should see a result similar to below if it is installed correctly.

Liquidsoap 2.0.6
Copyright (c) 2003-2022 Savonet team
Liquidsoap is open-source software, released under GNU General Public License.
See <http://liquidsoap.info> for more information.
Should you see an error message then we recommend to first attempt reinstalling liquidsoap as described further down in this article.

2. AutoDJ ‘DJ Listen Port’ could be in use by another process

  1. Enable Liquidsoap logging output (image right)
  2. Attempt to start AutoDJ on the service
  3. A file called liquidsoap.log should be generated in the Log Manager
  4. Open this file and search for the term “Address already in use in bind”.
  5. If you find this term then the problem is due to the port being used already and you will need to change the DJ Listen Port to another. You can simply clear the DJ Listen Port field and press save, the MediaCP will automatically select another port to use,
  6. Be sure to disable Liquidsoap logging output after troubleshooting or it will use a lot of disk space

3. AutoDJ is started but not playing any audio

In some rare circumstances we find that the shoutcast or icecast process running on the port might be from a previously “deleted” service in the MediaCP. This can occur when the shutdown process for the service previously utilising this port was not successful. In this scenario, AutoDJ is online but is unable to connect because the password is not valid.

To resolve the problem involves terminating the process running on the shoutcast/icecast port, then restarting from the control panel.

In the example below, we’re using a service on port 8000; be sure to change port 8000 to the portbase that your service is utilizing.

  1. Install netstat on the system, it will be used to see which process is running on the port:
    # CentOS / Almalinux
    yum install net-tools

    or

    # Debian / Ubuntu
    apt install net-tools
  2. Switch the service to Offline in the MediaCP
  3. Identify any processes still running on the port
    netstat -tulpn | grep 8000
  4. In this example, i can see that there is a process for icecast running on port 8000
  5. Because we already stopped the service in the control panel, we should terminate the remaining processes.
    kill -9 30199;
  6. Now restart the service from the MediaCP

4. Other issues

If you reach this step and the problem is still not solved, then there may be another error generated.

Sometimes a specific combination of settings, corrupted or incompatible mp3/aac track may cause failures to start.

You can review the end of the liquidsoap.log file (described in step 2 above) to locate any “Error” messages that may be relevant.

Reinstall liquidsoap

  1. Login as root user to SSH
  2. Run the following to start the MediaCP installation utility
    /root/init
  3. Select option [4] Admin Tools
  4. Select option [15] Liquidsoap – (Re)install

Install custom version of Liquidsoap

It is possible to install any branch/tag from liquidsoap using the following procedure. For example, the below procedure will install the latest rolling release for 2.0. You can replace “rolling-release-v2.1.x” with any branch/tag/version.

  1. Login to mediacp system account via SSH
    su mediacp
  2. Change to mediacp home directory
    cd ~
  3. Install/Update liquidsoap by pinning the source code
    opam pin -y liquidsoap 2.0.3-1
  4. Check installed version
    /usr/local/mediacp/liquidsoap/bin/liquidsoap --version
  5. Restart liquidsoap services
    pkill liquidsoap;
    sleep 5;
    pkill -9 liquidsoap;
    mediacp cron "bitrate=1 autodj_restart=1"

Table of Contents