VAPP - die Versammlungs-App

Alles, was eine Versammlung braucht

Zusammenkünfte, Gebiete, Trolley und Berichte — geplant in einer Anwendung, die auf eurem eigenen Server liegt.

Auf einen Blick

VAPP ist die zentrale Anlaufstelle einer Versammlung. Perfekt für Planer — Zusammenkünfte, Gebiete, Trolley, Saal und Berichte. Wer eingeplant ist, sieht hier, was ansteht — auf dem Handy, auch ohne Netz. Statt Zetteln, Aushängen und verteilten Tabellen gibt es einen Stand, digital und immer aktuell. Und er gehört der Versammlung: VAPP läuft auf eurem eigenen Server und nirgendwo sonst.

• 🗓️ Zusammenkünfte in Minuten — Arbeitsheft und Wachtturm als ePub einlesen, Aufgaben mit vorsortierten intelligenten Vorschlägen besetzen.
• 🗺️ Gebiete digital — Grenzen auf der Karte zeichnen, Personen zuweisen oder per QR-Code teilen, Karte als PDF.
• 🛒 Trolley zum Selberbuchen — Routen, Schichten und Statistik, ohne Listen zu führen.
• 📊 Predigtdienstbericht in der App — abgeben, erinnern, nachtragen; der Sekretär hat die Zahlen für jw.org fertig. Verschlüsselt und nach kurzer Zeit gelöscht.
• 📶 Unterwegs auch offline — Plan, eigene Gebiete samt Karte, Trolley und Kalender liegen auf dem Gerät, bevor der Empfang weg ist.
• 🔔 Nichts verpassen — Push, E-Mail, Eilmeldungen und Kalender-Abo.
• 🔐 Eure Daten, euer Server — Anmeldung per Passkey, Rechte nach Vorrechten und Aufgaben, kein Dienst dazwischen.

English: VAPP is a self-hosted congregation management app for Jehovah's Witnesses — Life and Ministry meeting scheduler with EPUB workbook import, weekend meeting and attendant schedules, territory maps and assignments, public witnessing cart scheduling, monthly field service reports, cleaning and hall schedules. Installable PWA with offline mode, push notifications, calendar feeds and passkey login. The interface ships in German, English, Greek and Russian; this page and the setup guide are German. Docker images ghcr.io/rbnet-apps/vapp-app and …/vapp-web for linux/amd64 and linux/arm64. Not an official tool of the organization.

In zwanzig Minuten ist die Versammlung erstellt

Kein Konto bei irgendwem, keine Anmeldung, kein Vertrag. Ein Rechner mit Docker, ein Befehl, der die Dateien holt, ein Einrichtungsskript, das alles Benötigte abfragt und jeden Schlüssel selbst erzeugt — danach führt ein Assistent durch die Ersteinrichtung: Versammlung, Zusammenkunftszeiten, Personen, Bereiche. Niemand muss vorher wissen, wie Docker oder eine Datenbank funktioniert.

Für wen

• Selbstverwaltung, Datenhoheit. Eine Versammlung, die ihre Planung selbst in der Hand behalten will.
• Planer: Koordinator, Dienstaufseher, Gebietsdiener, Trolley-Verantwortliche.
• Alle anderen, die schauen, wann sie eingeplant sind, ihr Gebiet bearbeiten wollen oder Trolleydienst eintragen — als WebApp installiert, mit Benachrichtigung und Kalender-Abo

Wofür nicht: VAPP ist kein offizielles Werkzeug der Organisation und ersetzt keins.

Alternativen

Wer schon eine Versammlungs-App wie NW Scheduler / NW Publisher, Hourglass, TheocBase, Organized oder Meeting Schedule Assistant kennt: VAPP deckt dieselben Aufgaben ab — Zusammenkünfte, Gebiete, Trolley, Berichte — in einer Anwendung. Der Unterschied: sie läuft auf eurem eigenen Server, nicht auf einem einzelnen PC und nicht bei einem fremden Anbieter.

Was die VAPP kann

🔐 Eigener Betrieb, eigene Daten

Selbst gehostet

• Die Anwendung läuft bei dir auf einem Rechner, bei einem Bruder der Versammlung oder einem beliebigen Server. Es gibt keinen kostenpflichtigen Dienst dazwischen, der mitliest, und keine Rechnung.

Anmeldung mit Passkey

• Fingerabdruck, Gesicht oder Geräte-PIN statt Passwort. Den ersten Zugang bekommt jeder als Einladung auf einem Zettel — ein QR-Code, der einmal gilt.

Jeder sieht, was er braucht

• Berechtigungen hängen an Vorrechten und Aufgaben und lassen sich individuell anpassen.

🗓️ Zusammenkünfte planen

Arbeitsheft/Wachtturm-Import

• Das ePub wird eingelesen und legt die Zusammenkünfte an. Lieder, Themen und Programmteile werden automatisch erstellt.
• Es muss nur noch die Planung der Aufgaben erfolgen.

Planungsassistent

• Der Ordnungsdienstplan kann automatisiert erstellt werden.
• Die Planung erfolgt basierend auf der Verfügbarkeit der Personen und Häufigkeit der letzten Dienste.

Vorsortierte Vorschläge

• Oben steht, wer lange nicht dran war und für diese Aufgabe freigegeben ist.
• Die Auswahl kennt den letzten und den nächsten Einsatz jeder Person und zeigt es direkt mit an.

🗺️ Gebiete

Karten erstellen

• Gebietsgrenzen werden im Kartenwerkzeug gezeichnet. Es wird kein separates Grafikprogramm benötigt. Als Online-Ansicht oder Druck per PDF als Gebietskarte.
• Wähle zwischen Kartenanbietern wie OpenStreetMap (weltweit) oder das Bundesamt für Kartographie und Geodäsie (Deutschland).

Gebiet teilen

• Scanne den QR-Code des Gebiets und teile es temporär mit deiner Gruppe. Einfache und sichere Freigabe für eine gemeinsame Bearbeitung.
• Jeder kann optional seinen eigenen Standort in der Gebietskarte anzeigen lassen.

Eigenständige Bearbeitung

• Eigenes Gebiet anzeigen, Adressen eintragen oder die Bearbeitung aktualisieren.
• Optional — es geht auch alles über den Gebietsdiener. Einfach per Parameter einstellen.

Dienstwochen mit allem, was dazugehört

• Die besondere Woche wird als Ganzes geplant, samt der Ausdrucke, die benötigt werden.
• Planung der verfügbaren Gebiete, benötigte Ausdrucke und eine Übersichtkarte - alles in einer eigenen Ansicht.

🏛️ Rund um den Saal

Abwesenheitsplan

• Wer abwesend ist, trägt es ein; die Planungsassistenten berücksichtigen es direkt bei den Vorschlägen.

Raumbelegung, Reinigung, Instandhaltung

• Haupt-, Zwischen- und Übergabereinigung
• wer welchen Raum wann belegt
• digitale Arbeitsblätter für die Instandhaltung
• und vieles mehr

Geteilter Saal, geteilter Plan

• Versammlungen, die sich einen Saal teilen, treten einer Versammlungs-Gruppe bei und stellen Reinigungspläne, Treffpunkte und allgemeine Termine versammlungsübergreifend bereit.

🛒 Trolley-Planung

Eigene Routen und Standorte

• Schichten und Zeiten werden einmal eingerichtet und laufen danach von selbst weiter
• optional können Abgaben pro Schicht eingetragen werden

Selbständige Planung

• Wer freigegeben wurde, bucht seine Schicht selbst — die Verantwortlichen sehen den Stand, statt Listen zu führen.

Statistik

• Verschaffe dir schnell einen Überblick, welche Route wie oft gebucht wird, welche Zeiten besonders gefragt sind oder in welchen Sprachen Abgaben erfolgen.

📊 Berichte

Predigtdienstbericht jeden Monat

• Die Versammlung schaltet den Bericht ein — ab diesem Monat wird gefragt. Ein Monat ohne Tätigkeit ist auch ein Bericht.
• Selbst abgeben oder abgeben lassen: Ist die Selbstabgabe an, trägt jeder selbst ein. Sonst tragen Gruppenaufseher und Sekretär ein.
• Wer das Notizbuch führt, holt dessen Zahlen mit einem Knopf in den Bericht.
• Fehlt ein Bericht, erinnert die App am 3. und am 10. des Monats.

Gruppenaufseher und Gehilfe

• Sehen, wer aus der Gruppe noch fehlt — auch als Zahl auf der Kachel.
• Erinnern mit einem Klick, tragen Meldungen auf Papier oder per Telefon im Dialog nach und laden die Gruppe als Excel.

Sekretär

• Sieht die ganze Versammlung nach Gruppen: offene Berichte, Gruppen ohne Aufseher, Personen ohne Gruppe.
• Bekommt die Zahlen für jw.org in der Reihenfolge des Formulars, bestätigt die Eingabe und erfährt von späteren Änderungen.
• Eine geführte Einrichtung zeigt Schritt für Schritt, was fehlt: Sekretär, Gruppenaufseher, Pionierliste, Selbstabgabe.

Datenschutz eingebaut

• Zahlen und Bemerkung liegen verschlüsselt in der Datenbank.
• Nichts wird aufbewahrt: Stunden, Studien und Bemerkung sind nach drei Monaten gelöscht, der Rest nach acht.
• Die App bewertet niemanden — kein „regelmäßig" oder „untätig", nur die letzten sechs Monate als Kästchen.

📣 Kommunikation und Überblick

Push und E-Mail

• Beides optional im eigenen Profil einstellbar.
• Benachrichtigt wird nur, wen es jeweils betrifft.

Eilmeldungen

• Versende eine Info an alle oder eine bestimmte Personengruppe — als Nachricht, die man nicht übersieht.

Kalender-Abo

• Verpasse keine Termine mehr. Abonniere die eigenen Einträge direkt in deiner Kalender-App des Smartphones oder Computers.

📶 Unterwegs und offline

Im Gebiet, im Keller, auf dem Land — kein Empfang ist kein Problem.

Als App installiert

• VAPP kommt als WebApp auf den Home-Bildschirm. Kein App-Store, kein Konto bei irgendwem.

Stammseiten laden von selbst

• Beim Öffnen der Startseite kommen Startseite, eigene Gebiete, aktueller Plan, Trolley-Plan und Kalender aufs Gerät — höchstens alle vier Stunden, auf Wunsch nur im WLAN.
• Abschalten geht im Profil unter „Geräte".

Für unterwegs laden

• Ein Knopf lädt alles auf einmal: Pläne samt nächster Periode, Termine für diesen und den nächsten Monat, die eigenen Gebiete mit Bild, QR-Code und Karte.
• Die Gebietskarte zeigt offline die zuletzt gesehenen Ausschnitte.

Immer klar, was aktuell ist

• Jede Seite aus dem Speicher trägt oben „Offline — geladen am …". Die Startseite zeigt, wann zuletzt geladen wurde und ob Seiten fehlen.

Die Technik - was gebraucht wird

• Linux-Rechner mit Docker und Compose-Plugin. Sowohl x86-64 als auch arm64 werden unterstützt.
• Eine eigene Domain, die auf diesen Rechner zeigt.
• Ein TLS-Zertifikat. VAPP bringt einen Reverse Proxy mit und holt es selbst bei Let's Encrypt — wer schon nginx oder Traefik davor hat, hängt es dahinter.
• Ein SMTP-Zugang zum Versenden der Mails aus der VAPP.
• Etwa zwanzig Minuten für die Ersteinrichtung.

Hinweis:

Eine IP-Adresse genügt nicht. Passkeys verlangen eine Domain und eine gesicherte Verbindung — der Browser führt die Anmeldung sonst gar nicht erst aus.

Ohne SMTP keine Einladungen. VAPP läuft, aber es kann niemanden per Mail einladen und kein Passwort zurücksetzen — auch nicht das eigene.

Loslegen

Alles, was zum Betrieb gehört — Compose-Datei, Einrichtungs-, Start-, Backup- und Restorescript und die vollständige Anleitung — steckt im Image.

mkdir -p ~/vapp && cd ~/vapp
docker run --rm ghcr.io/rbnet-apps/vapp-app:latest tar -C /opt/vapp-bundle -cf - . | tar -xf -
./setup.sh
./start.sh

Danach im Browser https://<domain>/commissioning aufrufen und das Betreiberkonto anlegen.

⚠️ Ein Schlüssel muss aufbewahrt werden. NOTES_ENCRYPTION_KEY verschlüsselt die Notizen in der Datenbank. Eine Sicherung, die ohne ihn zurückgespielt wird, hat Notizen, die niemand mehr lesen kann — nicht die Versammlung, nicht der Verfasser, niemand. setup.sh sagt das in dem Augenblick, in dem es ihn erzeugt.

Die ganze Anleitung ist SELFHOST.md — die fünf Schritte, die Sicherungen, was zu tun ist, wenn Probleme auftreten.

App aktualisieren

./start.sh --update

Demo Daten anlegen

docker compose exec php bin/console app:demo:seed

Demo Daten entfernen

docker compose exec php bin/console app:demo:remove

Die Images

Image	Was darin ist
ghcr.io/rbnet-apps/vapp-app	die Anwendung — PHP-FPM, die Konsole und die Dateien unter /opt/vapp-bundle
ghcr.io/rbnet-apps/vapp-web	nginx davor, mit der gebauten UI

Beide für linux/amd64 und linux/arm64 — ein gemieteter x86-Server und ein Raspberry Pi laufen gleich gut. latest ist die aktuelle Fassung; daneben hat jeder Build einen eigenen Commit Hash, über den man die Version festsetzen kann. MySQL und Redis sind nicht in diesen Images — sie kommen aus der Compose-Datei im Paket.

Womit es gebaut ist

Schicht	Was
Anwendung	Symfony 8.1, PHP 8.5, Doctrine ORM 3
Oberfläche	Twig serverseitig, TypeScript, SCSS, Bootstrap 5.3
Auslieferung	PWA — installierbar, Service Worker, Web Push. Keine native App.
Datenbank	MySQL 8.4
Zwischenspeicher	Redis, Symfony Messenger
PDF	Gotenberg (Chromium)

Lizenz

VAPP ist source-available, nicht Open Source: PolyForm Noncommercial 1.0.0 mit einem Zusatz. Kurz gesagt —

• Benutzen, verändern, weitergeben ist erlaubt. Die Grenze liegt beim Einsatz, nicht beim Kopieren.
• Nicht kommerziell — aber die eigenen Kosten zu decken, wenn man für andere Versammlungen hostet, ist ausdrücklich erlaubt. Das ist der Hauptfall und steht in der Lizenz.
• Weiterverkaufen, unterlizenzieren oder ein gewinnorientiertes Dienstangebot daraus machen: nicht erlaubt.

Die Nutzungsgrenze schließt ein Einsatzgebiet aus, darum ist die Lizenz nicht OSI-anerkannt und GitHub zeigt „Other". Das ist bei PolyForm normal, und source-available ist das zutreffende Wort.

Quelltext

Der Quelltext ist noch nicht veröffentlicht — vorerst gibt es nur die Images, das Repository folgt. Bis dahin werden hier die Lizenz und die Anleitung bereitgestellt.

Ein Sicherheitsproblem gefunden?

Bitte kein öffentliches Issue. Der Knopf Report a vulnerability im Reiter Security dieses Repositorys öffnet eine Meldung, die nur der Betreuer lesen kann. Wer ihn nicht sieht, schreibt an die Adresse aus der Zeile Required Notice: der LICENSE, Betreff vapp security. Einzelheiten in SECURITY.md.

---

VAPP wird von Brüdern in ihrer Freizeit entwickelt. Es ist kein offizielles Werkzeug der Organisation und steht in keiner Verbindung zu Jehovas Zeugen oder der Watch Tower Bible and Tract Society. Alle genannten Produktnamen gehören ihren Inhabern.