FreePBX Streaming Music On Hold

The future-ready MOH solution

There's a cure for repetitive, outdated musicboring default music on hold: FreePBX streaming music on hold from Easy On Hold® delivers live, licensed audio that keeps your callers engaged. Easy on Hold® created the first streaming music on hold service in 2013, helping IT teams, technicians, and contact centers provide dynamic, continuously updated caller experiences

Streaming MOH is a simple, reliable upgrade that keeps your FreePBX system current. No file uploads, no loops, and no downtime.

Free PBX Streaming Music On Hold Integration

Easy on Hold® streams work directly with FreePBX music on hold and Asterisk-based systems. Instead of static MP3 files, you can use a live HTTPS stream that updates automatically through the Content Control Center™.

  • 100% legal, licensed for business use
  • No repetitive loops—music plays continuously in randomized order
  • Schedule updates by time of day, day of week, or even season
  • Manage all streams and messages remotely via the Content Control Center™
  • Integrates easily with Asterisk, FreePBX, and many other UC platforms

Upgrading mpg123 for HTTPS

FreePBX natively uses mpg123 for streaming hold music and messages. Please check for the latest version of mpg123 to utilize HTTPS.

Upgrade Options

  • Download the latest mpg123 source code from the official website and install the newest version on your platform.
  • Upgrade to FreePBX 17, which supports HTTPS natively on its Debian-based build.
  • Easy On Hold® can provide a non-secure http HTTPS stream or HTTPS stream option.

How to set up a custom hold music stream in FreePBX

    Receive a music on holdmusic-on-hold stream URL from Easy On Hold®. It will look like this: https://eoh-prod-9-ns.easyonholdcloud.com/25d56c9f75dc4cc49214806c5d8621f1
  1. Under APPLICATIONS TAB > System Recordings
  2. Under SETTINGS TAB > Music On Hold
  3. On the far right there is the Add Streaming Category button - this is important
  4. In the field for Category Name - type EOH Stream to name the category
  5. In the field for Application -s enter your string(this is the command that will stream music FreePBX systems directly from your Easy On Hold® source) : /usr/bin/mpg123 -q -r 8000 -f 8192 -b 1024 --mono -s https://eoh-prod-6-ns.easyonholdcloud.com/55d86c9f65dc4cc49214906c6d8681f8
  6. Submit Changes
  7. Under CONNECTIVITY TAB > Inbound Routes
  8. Select MAIN INBOUND NUMBER
  9. Scroll down to Music On Hold field and select category: EOH Stream (the category you made)
  10. Call to test

Once configured, your system will stream music on hold FreePBX directly from the Easy On Hold® live, updating automatically with no manual uploads required.