tinyice-docker/README.md

📡 TinyIce Dockerized Stream Server

This repository contains the Docker configuration for TinyIce, a lightweight, high-performance Shoutcast/Icecast compatible streaming server. This setup is optimized for production use behind Nginx Proxy Manager (NPM).

---

🚀 Overview

TinyIce is a minimal streaming server written in Go. This Dockerized version ensures that the application remains portable while keeping your station settings, passwords, and listener history safe in a persistent volume.

Key Features

• Lightweight Base: Uses debian-slim to provide the necessary libraries for the TinyIce binary.
• Persistent Storage: All configuration and database files are stored in a local ./config folder.
• Metadata Support: Passes ICY metadata (Artist/Title) correctly to players like VLC and Winamp.
• Anti-Ban Architecture: Specifically configured to work with Reverse Proxies to prevent IP banning.

---

📂 Project Structure

tinyice-docker/
├── Dockerfile          # Environment setup (Debian-slim)
├── docker-compose.yml  # Container & Volume orchestration
├── tinyice-linux-amd64 # The application binary
└── config/             # (Auto-generated) Persistent data
    ├── tinyice.json    # Station settings & Admin passwords
    └── history.db      # SQLite database for "Now Playing" history