Commit All

deployment/README.md

@@ -0,0 +1,51 @@
+# 📅 Turmli Calendar - Raspberry Pi Deployment Guide
+
+This guide provides instructions for deploying the Turmli Bar Calendar Tool on a Raspberry Pi Zero (or other Raspberry Pi models) as a lightweight systemd service without Docker.
+
+## 🎯 Why No Docker?
+
+On resource-constrained devices like the Raspberry Pi Zero (512MB RAM, single-core CPU), Docker adds unnecessary overhead:
+- Docker daemon uses ~50-100MB RAM
+- Container layer adds ~20-30MB overhead
+- Additional CPU usage for containerization
+- Slower startup times
+
+Running directly as a systemd service provides:
+- ✅ Minimal resource usage
+- ✅ Faster startup
+- ✅ Direct hardware access
+- ✅ Simple management
+- ✅ Native systemd integration
+
+## 📋 Prerequisites
+
+### Hardware Requirements
+- **Raspberry Pi Zero/Zero W** (minimum) or any Raspberry Pi model
+- **SD Card**: 8GB minimum (Class 10 or better recommended)
+- **Network**: Ethernet adapter or WiFi
+- **Power**: Stable 5V power supply
+
+### Software Requirements
+- **OS**: Raspberry Pi OS Lite (32-bit recommended)
+- **Python**: 3.9 or newer
+- **Memory**: ~100-150MB free RAM
+- **Storage**: ~200MB free space
+
+## 🚀 Quick Installation
+
+```bash
+# 1. Copy the deployment script to your Pi
+scp deploy_rpi.sh pi@raspberrypi:/home/pi/
+
+# 2. SSH into your Pi
+ssh pi@raspberrypi
+
+# 3. Clone or copy the application
+git clone <repository-url> turmli-calendar
+cd turmli-calendar
+
+# 4. Run the deployment script
+sudo ./deploy_rpi.sh install
+```
+
+The application will be available at `http://<pi-ip-address>:8000`