Initial setup

README.md

@@ -1,2 +1,27 @@
-# tinyice-docker
+# 📡 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
+```text
+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