mangup/shoutcast repository overview

⁠🎵 Shoutcast Server with Docker

A lightweight, containerized Shoutcast streaming server using mangup/shoutcast⁠ image. Perfect for setting up internet radio streams quickly and reliably.

⁠🔧 Features

• ✅ Runs Shoutcast v2.6.1.777 (SC2) in a Docker container
• ✅ Easy volume mounting for config and control files
• ✅ Automatic restart on failure (restart: always)
• ✅ Exposes HTTP (port 8000) and ICY (port 8001) ports
• ✅ Configurable via external files
• ✅ Minimal setup with docker-compose.yml

⁠📦 Prerequisites

Before running this project, ensure you have:

• Docker⁠ installed
• Docker Compose⁠ installed

⁠🚀 Quick Start

1. Create the project directory

mkdir shoutcast-docker && cd shoutcast-docker

1. Create the required directories

mkdir -p conf control logs

1. Create docker-compose.yml (as provided in your request):

version: '3.8'

services:
  shoutcast_server:
    image: mangup/shoutcast:latest
    ports:
      - "8000:8000"   # HTTP admin & stream access
      - "8001:8001"   # ICY stream port
    volumes:
      - ./conf:/opt/shoutcast/conf
      - ./control:/opt/shoutcast/control
      - ./logs:/opt/shoutcast/logs
    restart: always

networks: {}

1. Start the container

docker-compose up -d

✅ Your Shoutcast server is now running at:

• Admin Interface: http://localhost:8000

⁠📂 Configuration Example

⁠✅ Required Files

You must create the following files inside the conf/ directory:

⁠sc_serv.conf — Main Shoutcast Server Configuration

# sc_serv.conf - Shoutcast Server Configuration
; NOTE: for any relative paths specified are relative to
; sc_serv and not to where the conf file is being stored

logfile=logs/sc_serv.log
w3clog=logs/sc_w3c.log
banfile=control/sc_serv.ban
ripfile=control/sc_serv.rip
portbase=8000
password=testing
; password used for accessing the administation pages
; NOTE: remember to change this to something else
adminpassword=changeme

⁠🔐 Security Tips

• ❌ Never use default passwords like admin/changeme.
• ✅ Change AdminPassword and Password to strong, unique values.
• ✅ Consider enabling HTTPS via reverse proxy (e.g., Nginx + Let’s Encrypt).
• ✅ Restrict access to 8000 and 8001 ports using firewall rules if exposed publicly.

⁠🛠 ️ Useful Commands

⁠🙋..♂ ️ Support & Feedback

Found a bug? Want a feature? Open an issue or send a pull request!

🎵 Happy broadcasting!.. Powered by Docker & Shoutcast v2

Let me know if you'd like a version with HTTPS, reverse proxy integration (Nginx), or automated backups!