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.

How to set up a custom hold music stream in FreePBX

  1. Receive a music on hold stream URL from Easy On Hold®. It will look like this (shown: demonstration, not a functioning stream): http://eoh-prod-9-ns.easyonholdcloud.com/25d56c9f75dc4cc49214806c5d8621f1
  2. Test the stream URL in a browser to ensure audio plays
  3. Under Settings select Music On Hold
  4. Choose Add Streaming Category
  5. In the field for Category Name - type Easy On Hold Stream to name the category
  6. In the Type field, choose Custom Application
  7. Screenshot FreePBX 17 Choose Category and Type
  8. Edit the new category. On the edit page you will enter the following parameters, including the stream URL. Example: /usr/bin/mpg123 -q -r 8000 -f 8192 -b 1024 --mono -s http://eoh-prod-9-ns.easyonholdcloud.com/25d56c9f75dc4cc49214806c5d8621f1
  9. Submit Settings
  10. Leave Optional Format blank
  11. Screenshot FreePBX 17 Edit Category
  12. Apply to Call Queue(s): When setting up a Call Queue or editing an existing Call Queue, the new category for the stream will be selectable from the dropdown. Select it and Submit the settings.
  13. Screenshot FreePBX 17 Submit Settings
  14. Click Apply Config
  15. Call the queue 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. Instructions found at FreePBX.org

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.