Installation Guide

Deploy on Raspberry Pi

Leiturgia runs on a Raspberry Pi on your local church network. Setup takes under 5 minutes. All displays — projector, TVs, mobile remote — connect via the local network browser.

Prerequisites

✓
Raspberry Pi
Any model with network access. Raspberry Pi 3B+ or newer recommended. Running Raspberry Pi OS (32 or 64-bit) or DietPi.
✓
Internet connection
Required during install to download dependencies. Not needed after setup — Leiturgia runs fully offline on your local network.
✓
SSH access or a keyboard/monitor
You need a terminal on the Pi to run the install command.

Install

1
Open a terminal on your Pi
SSH in from another machine or open a terminal directly on the Pi.
from your computer
ssh pi@<pi-ip-address>
2
Run the install script
This installs all dependencies, clones the app to /opt/leiturgia, creates a Python virtual environment, and registers a systemd service that starts on boot.
curl -fsSL https://raw.githubusercontent.com/darqlab/leiturgia/main/scripts/install.sh | sudo bash
Note: The script will print your Pi's IP address and the default PIN (1234) when it finishes. Change the PIN before going live.
3
Change the default PIN
The remote control is PIN-protected. Edit the config file to set your own PIN, then restart the service.
sudo nano /opt/leiturgia/config.json
sudo systemctl restart leiturgia

Access the App

Open any of these URLs from a browser on your local network — laptop, tablet, or TV.

Operator Console http://<pi-ip>:5000 Program editor and controls
Main Projection http://<pi-ip>:5000/ch1 Connect projector or main TV
Rundown Display http://<pi-ip>:5000/ch2 Order of service for the platform
Timer Display http://<pi-ip>:5000/ch3 Speaker timer screen
Mobile Remote http://<pi-ip>:5000/remote PIN-protected slide control
Tip: Find your Pi's IP address by running hostname -I on the Pi, or checking your router's device list.

Managing the Service

→
Check status
sudo systemctl status leiturgia
→
Restart after config changes
sudo systemctl restart leiturgia
→
View live logs
journalctl -u leiturgia -f
→
Update to latest version
Re-running the install script updates the app and restarts the service.
curl -fsSL https://raw.githubusercontent.com/darqlab/leiturgia/main/scripts/install.sh | sudo bash