52 lines
1.5 KiB
Markdown
52 lines
1.5 KiB
Markdown
# 📅 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`
|