Table of Contents
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Installation
Voraussetzungen
- Docker + Docker Compose
- Eine Nextcloud-Instanz mit aktivierter Kalender-App (für Aufgaben zusätzlich die Tasks-App)
- Eine authentik-Instanz als OIDC-Provider
- Ein OpenRouter-Account mit API-Key
- Ein Reverse Proxy mit HTTPS (z. B. Nginx Proxy Manager) – das Mikrofon funktioniert nur über HTTPS
Schnellstart
git clone https://git.itdata-gera.de/chinux/VoiceCal.git
cd VoiceCal
cp .env.example .env
# .env ausfüllen – siehe [[Konfiguration]]
docker compose up -d --build
Der Dienst lauscht danach auf Port 8080. Diesen Port im Reverse Proxy auf deine Domain
(z. B. https://voicecal.example.de) mappen und ein Let's-Encrypt-Zertifikat ausstellen.
Wichtig: Das Mikrofon im Browser braucht einen sicheren Kontext (HTTPS). Teste die App immer über die HTTPS-Domain, nicht über
http://IP:8080. Ohne HTTPS funktioniert nur die Texteingabe.
Erststart
Beim ersten Start lädt das Backend einmalig das Whisper-Modell herunter (im whisper-models-Volume
gecacht). Das kann ein paar Minuten dauern; danach geht es schnell.
Als PWA installieren
- Android (Chrome): Menü → „App installieren" bzw. „Zum Startbildschirm hinzufügen".
- iOS (Safari): Teilen-Symbol → „Zum Home-Bildschirm". Die App startet dann im Vollbild wie eine native App; der schwebende Mikro-Button sitzt korrekt über der Home-Leiste.
Updates
git pull
docker compose up -d --build
Die Laufzeit-Einstellungen (gewähltes LLM-Modell) bleiben im settings-Volume erhalten.