📅 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

# 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