Zum Inhalt springen
Stundenhüter

2 Installation

Unter Windows geschieht die Installation nur mit Doppelklick und „Weiter“. Du brauchst keine Eingaben in Konsolenfenstern. Für den Mac gibt es einen Installer (Abschnitt „Installation auf dem Mac“), für Linux Pakete für Debian und Ubuntu (Abschnitt „Installation unter Linux“). Keine dieser Installationen braucht Internet.

Systemvoraussetzungen

Mindestens Empfohlen
Windows Windows 10 ab 1809 / Server 2019, x64, 4 GB RAM Windows 11 / Server 2022, 8 GB RAM, SSD
Linux 64 Bit (amd64/arm64), Debian 12 oder Ubuntu 22.04, 2 GB RAM Debian 12 / Ubuntu 24.04, 4 GB RAM, SSD
Mac macOS 11 oder neuer (Apple Silicon und Intel), 2 GB RAM aktuelles macOS, 4 GB RAM, SSD
Speicherplatz 1 GB frei 5 GB frei, lokale Platte

Unter 1 GB freiem Speicherplatz bricht die Installation ab, unter 4 GB (Windows) bzw. unter 2 GB Arbeitsspeicher warnt sie nur. Im Betrieb braucht Stundenhüter etwa 125 MB Arbeitsspeicher.

  • Windows-Server: Windows Server 2022. Die Programmdateien verlangen mindestens Windows 10 Version 1809, das entspricht Windows Server 2019.
  • Installationsordner (Windows): auf einer lokalen Festplatte, Vorschlag C:\Zeiterfassung. Nicht erlaubt sind Netzlaufwerke, \\server\...-Pfade, subst-Laufwerke und Wechseldatenträger. Das Setup lehnt sie ab.
  • Daten (Windows): liegen in C:\ProgramData\Zeiterfassung, ebenfalls auf einer lokalen Platte.
  • Netzwerk: Tablets, Handys und PCs erreichen den Server im Haus-Netz (LAN oder WLAN). Internet ist nicht nötig.
  • Uhrzeit: Gestempelt wird mit der Uhr des Servers. Sie muss stimmen (siehe Kapitel 11, „Die Uhrzeit stimmt nicht“).
  • Browser: ein aktueller Browser auf Tablet, Handy oder PC.

Server-Setup (Erstinstallation)

  1. Kopiere die Datei Stundenhueter-Setup-<Version>.exe auf den Server.
  2. Doppelklicke die Datei.
  3. Bestätige die Rückfrage von Windows (Administrator) mit „Ja“.
  4. Klicke auf „Weiter“. Das Setup fragt nach dem Installationsordner (Vorschlag C:\Zeiterfassung) und nach dem Port.
  5. Warte, bis „Fertig“ erscheint. Lass das Häkchen „Stundenhüter im Browser öffnen“ gesetzt.
  6. Der Browser öffnet die Ersteinrichtung (siehe Kapitel 3).

Ersteinrichtung von einem anderen Gerät: Den ersten Admin legt der Server selbst ohne Weiteres an (http://localhost, so öffnet es das Setup). Öffnest Du die Ersteinrichtung auf einem anderen Gerät (zum Beispiel bei Docker oder auf einem Raspberry Pi), fragt sie nach dem Einrichtungscode. Er steht beim Start im Protokoll des Servers in der Zeile „Einrichtungscode: …“ (8 Ziffern, bei Docker mit docker compose logs) und gilt bis zur Einrichtung; nach einem Neustart des Servers gilt ein neuer Code, der alte nicht mehr. Nach 5 falschen Codes sperrt die Seite dieses Gerät für einige Minuten. Die Ersteinrichtung von einem anderen Gerät läuft über http://, Code und Passwort gehen dabei unverschlüsselt durchs Netz: Richte am besten am Server selbst ein. Ein Reverse-Proxy auf demselben Rechner ist nicht vorgesehen, weil dann alle Geräte wie der Server selbst aussehen würden.

Der Port: Die Vorgabe ist 80. Dann lautet die Adresse einfach http://Servername/. Ist Port 80 belegt (z. B. durch IIS), nimmt das Setup automatisch den ersten freien Port ab 8080. Die Adresse enthält dann die Portnummer, z. B. http://Servername:8080/. Wählst Du ausdrücklich einen anderen Port und er ist belegt, bricht das Setup mit „Port X ist belegt von …“ ab.

Das Setup richtet den Dienst (startet automatisch mit Windows), die Firewall-Regel und im Startmenü den Ordner „Stundenhüter“ ein. Dort findest Du:

  • Stundenhüter öffnen
  • Diagnose erstellen
  • Port ändern
  • Deinstallieren

Meldung von Windows SmartScreen

Das Setup ist nicht digital signiert. Beim ersten Start zeigt Windows deshalb „Der Computer wurde durch Windows geschützt“. Klicke auf „Weitere Informationen“ und dann auf „Trotzdem ausführen“.

Port später ändern

Wähle im Startmenü Stundenhüter → Port ändern und bestätige die Rückfrage von Windows. Im Fenster fragt es den HTTP-Port und den HTTPS-Port ab und schlägt jeweils den aktuellen vor (HTTPS: Standard 443). Das Programm prüft, ob der Port frei ist, und setzt bei einem Fehler alles zurück. Danach stellst Du Tablets, Lesezeichen und Client-Apps auf die neue Adresse um. Ändert sich der HTTPS-Port, betrifft das Lesezeichen, Stempel-Links und QR-Codes sowie eingerichtete Clients (dort: „Server-Adresse ändern“). Passe auch einen festen Eintrag unter Einstellungen → Server-Adresse an. Persönliche Links und QR-Codes enthalten die Adresse; gib sie bei Bedarf neu aus.

Arbeitsplatz-Setup (Client-App)

Die Windows-App für Arbeitsplätze öffnet Stundenhüter im Standardbrowser des PCs. Sie verändert nichts auf dem Server. Du brauchst sie nicht unbedingt: Die Adresse im Browser zu öffnen reicht auch.

  1. Kopiere Stundenhueter-Client-Setup-<Version>.exe auf den PC.
  2. Doppelklicke die Datei. Administratorrechte braucht sie nicht.
  3. Folge dem Setup bis zum Ende.
  4. Beim ersten Start fragt die App nach Server-Adresse, HTTPS und den Ports. Sie merkt sich alles. Mit dem vorbelegten Haken „HTTPS (empfohlen, verschlüsselt)“ lädt sie die Zertifizierungsstelle des Servers, zeigt ihren Fingerabdruck und trägt sie nach Deiner Bestätigung für das Windows-Konto ein; Windows fragt dabei noch einmal nach („Ja“). Klappt das nicht, öffnet sich die Seite „Geräte einrichten“ (siehe unten). Vergleiche den Fingerabdruck im Dialog der App (SHA-256) mit einer unabhängigen Quelle: am Server unter Einstellungen → Sicherheit (dort im Browser über https://localhost geöffnet), mit der Ausgabe von Setup oder Diagnose oder mit einem Ausdruck der Verwaltung – nicht mit der Seite „Geräte einrichten“, denn die kommt unverschlüsselt und könnte unterwegs verändert sein. Die Windows-Rückfrage zeigt dagegen einen SHA-1-Fingerabdruck, der sich nicht mit dem SHA-256 vergleichen lässt. Lass Dich davon nicht verwirren, maßgeblich ist der Vergleich im Dialog der App. Ist der Server älter als 1.39.0, weist die App darauf hin; dann stellst Du sie auf http um. Zeigt der Browser danach noch „Nicht sicher“ an, starte ihn einmal ganz neu (in Edge edge://restart in die Adresszeile eingeben) oder starte den Rechner neu. Browser merken sich eine frühere Warnung, bis sie neu starten.

Es entstehen Verknüpfungen auf dem Desktop und im Startmenü. Die Server-Adresse änderst Du später im Startmenü mit dem Eintrag „Server-Adresse ändern“. Auch hier kann SmartScreen warnen: „Weitere Informationen“, dann „Trotzdem ausführen“.

Arbeitsplatz-App am Mac

Auch für den Mac gibt es eine Arbeitsplatz-App: macOS 11 oder neuer, Apple Silicon und Intel (eine Datei für beide). Sie öffnet Stundenhüter im Standardbrowser des Macs und verändert nichts auf dem Server. Du brauchst sie nicht unbedingt: Die Adresse im Browser zu öffnen reicht auch.

  1. Kopiere Stundenhueter-Client-macOS-<Version>.pkg auf den Mac.
  2. Starte die Datei mit einem Doppelklick, klicke Dich mit Fortfahren durch den Installer und gib am Ende das Passwort eines Administrator-Benutzers dieses Macs ein (das Installieren braucht Administratorrechte). Die App liegt danach im Ordner „Programme“.
  3. Beim ersten Start fragt die App nach der Server-Adresse (Name oder IP, auch mit Port oder als https://…) und ob HTTPS genutzt werden soll. Mit HTTPS lädt sie die Zertifizierungsstelle des Servers und zeigt ihren Fingerabdruck. Vergleiche ihn (SHA-256) mit einer unabhängigen Quelle: am Server unter Einstellungen → Sicherheit (dort im Browser über https://localhost geöffnet), mit der Ausgabe von Setup oder Diagnose oder mit einem Ausdruck der Verwaltung – nicht mit der Seite „Geräte einrichten“, denn die kommt unverschlüsselt. Nach Deiner Bestätigung trägt die App die Zertifizierungsstelle im Schlüsselbund „Anmeldung“ ein; macOS fragt dabei nach dem Passwort Deines Mac-Benutzers.
  4. Danach öffnet jeder Start Stundenhüter direkt im Browser.

Die Adresse änderst Du später, indem Du die App mit gedrückter Taste ⌥ (Wahltaste) startest. Die Einstellungen stehen in ~/Library/Application Support/Stundenhueter/client.ini.

Auf dem Mac, auf dem der Stundenhüter-Server läuft, installierst Du die Arbeitsplatz-App nicht: Der Installer bricht dort mit einem Hinweis ab, denn die Server-App „Stundenhüter“ öffnet die Verwaltung bereits.

Entfernen: Lege die App „Stundenhüter“ aus dem Ordner „Programme“ in den Papierkorb und lösche in der App „Schlüsselbundverwaltung“ im Schlüsselbund „Anmeldung“ den Eintrag „Stundenhüter …“ (die Zertifizierungsstelle des Servers).

Tablet einrichten

Das Tablet braucht nur einen Browser. Es wird nichts installiert.

  1. Verbinde das Tablet mit dem WLAN des Hauses.
  2. Öffne im Browser die Adresse des Servers, z. B. http://Servername/.
  3. Es erscheint die Startseite „Wer bist du?“ mit den Kacheln der Mitarbeitenden.
  4. Lege ein Lesezeichen an.

Trage vorher unter Einstellungen → Server-Adresse den Rechnernamen oder die feste IP-Adresse des Servers ein (Kapitel 8). Sonst können Links und QR-Codes eine falsche Adresse enthalten.

Nach kurzer Inaktivität meldet sich das Tablet von selbst ab und zeigt wieder die Startseite.

HTTPS und Geräte einrichten

Ab Version 1.39.0 spricht Stundenhüter zusätzlich HTTPS: PINs, Passwörter und Zeiten gehen dann verschlüsselt durchs Netz. Das Setup fragt dafür auf der Seite „Port“ den HTTPS-Port ab (Standard 443; ist er belegt, nimmt es den ersten freien Port ab 8443). Still: /HTTPSPORT=8443. Die Firewall-Regel gilt für beide Ports. Bei einem Update bleibt ein vorhandener HTTPS-Port erhalten, solange er frei ist. Am Ende öffnet das Setup die Startseite (https://localhost/, sonst http://localhost/). Die Seite „Geräte einrichten“ erreichst Du jederzeit unter /einrichten (ab 1.52.0 auch über das Menü der Startseite, „Gerät einrichten“), auch über HTTP und auch bei „Nur noch HTTPS“. Öffnest Du sie auf dem Server selbst, zeigt der QR-Code die Adresse im Netz (nicht localhost).

Stundenhüter hat dafür eine eigene Zertifizierungsstelle (zum Beispiel „Stundenhüter PRAXISSRV“). Jedes Gerät muss ihr einmal vertrauen, sonst zeigt der Browser eine Warnung. Auf dem Server erledigt das Setup das selbst.

So richtest Du die übrigen Geräte ein:

  1. Öffne auf dem Gerät http://Servername/einrichten (mit Port, falls nicht 80). Die Seite zeigt die neue Adresse https://…, einen QR-Code und den Fingerabdruck der Stelle.
  2. iPad und iPhone: „Profil für iPad und iPhone laden“ → Einstellungen → Allgemein → VPN und Geräteverwaltung → Profil „Stundenhüter …“ → Installieren (der Hinweis „Nicht signiert“ ist normal) → danach Allgemein → Info → Zertifikatsvertrauenseinstellungen → die Stelle einschalten. Ohne diesen letzten Schritt meldet „Verbindung testen“ weiter „Noch nicht eingerichtet“.
  3. Android: „Zertifikat laden“ → Einstellungen → Sicherheit → Verschlüsselung und Anmeldedaten → CA-Zertifikat installieren → stelle.crt wählen.
  4. Windows-PC ohne Client-App: „Zertifikat laden“ → Doppelklick auf stelle.crt → Zertifikat installieren → „Alle Zertifikate in folgendem Speicher speichern“ → Vertrauenswürdige Stammzertifizierungsstellen. Mit der Client-App geht das beim Einrichten von selbst.
  5. Mac: Doppelklick auf stelle.crt → Schlüsselbund Anmeldung wählen (nicht „iCloud“, dort hängt sich die Schlüsselbundverwaltung auf). Ein Dialog zum Vertrauen kommt nicht: links „Anmeldung“ → „Zertifikate“ → „Stundenhüter …“ doppelklicken → Vertrauen → Immer vertrauen → Fenster schließen, erst dann fragt der Mac nach dem Passwort. Schneller im Terminal, danach einmal das Passwort eingeben: security add-trusted-cert -r trustRoot -k ~/Library/Keychains/login.keychain-db ~/Downloads/stelle.crt. Das gilt nur für den Mac; iPhone und iPad richtest Du direkt auf dem Gerät mit dem Profil ein.
  6. Firefox übernimmt die Stellen des Systems nicht immer: Einstellungen → Datenschutz & Sicherheit → Zertifikate anzeigen → Zertifizierungsstellen → Importieren.
  7. Tippe auf „Verbindung testen“. Grün heißt: Das Gerät ist eingerichtet. Stelle dann Lesezeichen und Tablets auf die https://-Adresse um.

Vergleiche den Fingerabdruck, wenn ein Gerät ihn beim Vertrauen anzeigt, mit einer unabhängigen Quelle: am Server unter Einstellungen → Sicherheit (im Browser des Servers über https://localhost geöffnet), mit der Ausgabe von Setup oder Diagnose oder mit einem Ausdruck der Verwaltung. Der Wert auf der Seite „Geräte einrichten“ allein genügt nicht, weil die Seite unverschlüsselt kommt. Ab 1.70.0 steht er dort hervorgehoben unter „Vor dem Vertrauen prüfen“, und das Profil für iPad und iPhone nennt ihn in seiner Beschreibung. So vergleichst Du: Öffne am Server Einstellungen → Sicherheit und lies dort den Fingerabdruck ab (oder nimm die Ausgabe von Setup oder Diagnose). Vergleiche alle Vierergruppen mit dem Wert auf dem Gerät. Stimmt auch nur eine Gruppe nicht, brich ab und melde es der Verwaltung. Verwende für den Aufruf den Rechnernamen oder die IP-Adresse; Namen wie server.fritz.box stehen nicht im Zertifikat und lösen eine Warnung aus.

HTTP läuft weiter. Erst wenn alle Geräte eingerichtet sind, schaltest Du unter Einstellungen → Sicherheit auf „Nur noch HTTPS“ um (Kapitel 8). Die Liste „Zuletzt noch über HTTP“ zeigt Dir, welche Geräte noch fehlen.

Verwaltung nur über HTTPS (ab 1.41.0): Läuft HTTPS, geht die Verwaltung schon vorher nur noch über https://: http://Servername/admin leitet um, die Anmeldung über http:// wird abgelehnt. Richte deshalb zuerst die PCs der Verwaltung ein. Stempeln und Mein Bereich bleiben über http:// erreichbar, am Server selbst (http://localhost) auch die Verwaltung.

Firewall: Die Regel „Zeiterfassung“ lässt nur Geräte aus dem eigenen Netz (Subnetz) herein und gilt ab 1.70.0 nur für die Netzwerkprofile „Domäne“ und „Privat“, nicht für „Öffentlich“ (etwa ein Gäste-WLAN). Stuft Windows eine Verbindung des Servers als „Öffentlich“ ein (häufig bei Servern ohne Domäne) oder lässt sich das nicht feststellen, schränkt das Setup die Regel nicht ein, damit Tablets und PCs den Server weiter erreichen: Eine vorhandene Regel bleibt, wie sie ist, eine neue gilt für alle Profile. Am Ende meldet das Setup das deutlich und nennt den Befehl, mit dem Du das Praxisnetz auf „Privat“ stellst: Set-NetConnectionProfile -InterfaceAlias "<Name>" -NetworkCategory Private (PowerShell als Administrator; den Namen zeigt Get-NetConnectionProfile). Das nächste Update beschränkt die Regel dann auf „Domäne“ und „Privat“. Andere Namen: Rufst Du den Server unter einem weiteren Namen auf (zum Beispiel zeit.praxis.de), trage ihn in ZE_HOSTS ein (siehe „Update auf 1.21.2“); dann steht er auch im Zertifikat.

Als App auf dem Handy

Ab Version 1.63.0 lässt sich Stundenhüter auf Handy und Tablet wie eine App nutzen (Web-App, keine Store-App). Die Seite „Geräte einrichten“ erklärt im Abschnitt „Als App hinzufügen“, wie es geht:

  • iPhone und iPad: Seite in Safari öffnen → Teilen → „Zum Home-Bildschirm“ → „Hinzufügen“.
  • Android: Seite in Chrome öffnen → Menü (drei Punkte) → „App installieren“ (oder „Zum Startbildschirm hinzufügen“).

Lege das Symbol über die https://-Adresse an, nachdem das Gerät eingerichtet ist. Nur dann lädt die App ihre Oberfläche aus dem Speicher des Geräts (schnellerer Start) und zeigt ohne Verbindung den Hinweis „Stundenhüter ist gerade nicht erreichbar“ („Sie sind vermutlich nicht im WLAN des Betriebs“) mit „Erneut versuchen“ statt einer Fehlerseite des Browsers. Über http:// geht es auch, aber ohne diese beiden Vorteile; Android legt dann nur eine Verknüpfung an.

Was auf dem Gerät gespeichert wird: nur die Oberfläche (Programmdateien, Symbole, Schriften), keine Zeiten, Namen oder anderen Daten. Seiten und alle Daten kommen immer frisch vom Server. Stempeln ohne Verbindung geht bewusst nicht: Maßgeblich ist die Uhrzeit des Servers, und die lässt sich am Handy nicht verstellen.

Nach einem Update holt sich die App die neue Oberfläche beim nächsten Öffnen. Eine offene Start- oder Stempelseite (Tablet am Empfang) lädt von selbst neu, sobald sie eine Minute lang nicht bedient wird. Auf allen anderen Seiten erscheint oben „Neue Version – bitte neu laden.“; ein Tipp auf „Neu laden“ zeigt die neue Version.

Feste Adresse: Das Symbol merkt sich die Adresse, unter der es angelegt wurde. Gib dem Server deshalb eine feste IP-Adresse (im Router reservieren, bei der FRITZ!Box: „Diesem Netzwerkgerät immer die gleiche IPv4-Adresse zuweisen“) und trage sie unter Einstellungen → Server-Adresse ein (Kapitel 8). Rechnernamen lösen Handys im WLAN nicht immer auf; die feste IP-Adresse ist am zuverlässigsten. Ändert sich die Adresse, muss jedes Symbol neu angelegt werden.

Eigene Anmeldung: Auf iPhone und iPad hat die App vom Home-Bildschirm eigene Cookies, getrennt von Safari. Wer in Safari angemeldet ist, meldet sich in der App einmal neu an (Mein Bereich, Verwaltung). Der persönliche Stempel-Link braucht keine Anmeldung.

Persönlicher Stempel-Link: Legst Du das Symbol von Deinem persönlichen Link aus an, öffnet ein Tipp direkt Deine Stempelseite (Kapitel 4). Gestempelt wird erst mit dem Tipp auf den Stempelknopf; das Öffnen allein stempelt nie.

Update

  1. Kopiere die neue Setup-Datei auf den Server.
  2. Doppelklicke sie, bestätige mit „Ja“, klicke auf „Weiter“.
  3. Warte auf „Fertig“.

Die Willkommensseite zeigt „Aktualisierung von X auf Y“. Das Setup macht dabei selbst eine Sicherung der Daten, behält Ordner und Port und stellt bei einem Fehler die alte Version automatisch wieder her. Klappt die Sicherung nicht (z. B. zu wenig Platz), bricht das Update ab und die bisherige Version läuft weiter. Den Ort der Sicherung zeigt die Fertig-Seite: C:\ProgramData\Zeiterfassung\backup\vor-update-<alte Version>-<Datum-Uhrzeit>.

Ändert ein Update die Datenbank, legt das Programm beim ersten Start vorher automatisch eine weitere Sicherung an (vor-migration-…). Du musst nichts tun.

Ob das Update geklappt hat, siehst Du im Menü unter Info. Dort steht die Version.

Ein Zurück auf eine ältere Version ist nicht vorgesehen. Wenn nötig, spielst Du die Sicherung vor dem Update ein (Kapitel 9) – Buchungen seit dem Update gehen dabei verloren. Stellt das Setup nach einem Fehler die alte Version wieder her, siehe „Update auf 1.13.0“.

Update auf 1.11.0: Mit dieser Version gibt es eine Lizenz (Kapitel 3). Auch bei bestehenden Installationen beginnt mit dem ersten Start der Version eine Testphase von 30 Tagen.

Update auf 1.12.0: Neu ist der Arbeitszeit-Wächter (Kapitel 5). Er ist nach dem Update eingeschaltet; ausschalten kannst Du ihn unter Einstellungen → Funktionen. Vor der Änderung der Datenbank legt das Programm automatisch eine Sicherung an.

Update auf 1.13.0: Neu sind das Änderungsprotokoll und die Prüfungsmappe (Kapitel 12). Wer Zeiten von Hand ändert, anlegt oder löscht, muss ab jetzt einen Grund angeben. Mit dem ersten Start beginnt die Prüfkette; im Protokoll steht dazu der Eintrag „Prüfkette begonnen“. Ältere Zeiten, die nicht zum bisherigen Protokoll passen, zählen als „vor Protokollbeginn“ und nur als Hinweis. Vor der Änderung der Datenbank legt das Programm automatisch die Sicherung vor-migration-<alte Schemanummer>-….db an, z. B. vor-migration-18-… beim Update von 1.10.0 und vor-migration-19-… von 1.12.0. Lief danach doch wieder eine ältere Version (etwa nach einem Rückfall beim Update), setzt 1.13.0 die Prüfkette beim nächsten Start sichtbar fort; im Protokoll steht dann „Prüfkette fortgesetzt nach Betrieb mit älterer Version“. Korrekturen aus dieser Zeit haben keinen Grund, weil die ältere Version keinen verlangt.

Update auf 1.14.0: Neu ist der DATEV-Export (Kapitel 13, ab Werk ausgeschaltet). Die Datenbank bekommt zwei Felder (Entlohnung je Person, Art der Korrekturbuchung); vorher legt das Programm automatisch die Sicherung vor-migration-20-….db an. Bestehende Daten bleiben unverändert.

Update auf 1.15.0: Neu sind bezahlte Stunden an Abwesenheitstagen und die Stundenmeldung (Kapitel 5 und 7). Die Datenbank bekommt eine Tabelle für von Hand geänderte Stunden; vorher legt das Programm automatisch die Sicherung vor-migration-21-….db an. Bestehende Daten bleiben unverändert.

Update auf 1.16.0: Neue Farbwelt, Bedienung am Handy, Kennzahlen und „Zu tun“ in der Übersicht, aufklappbare Einstellungen (Kapitel 5 und 8). Der Aufbau der Datenbank bleibt unverändert. Ein gespeichertes Farbthema „Kobalt“ stellt das Update einmalig auf Petrol um; andere Farbthemen bleiben. Zurückstellen kannst Du es unter Einstellungen → Farbthema (Kapitel 8).

Update auf 1.17.0: Der Dienstplan bekommt Reiter, eine Statusleiste, die Liste „Besetzung“, Schnellfilter und eine Zusammenfassung vor dem Veröffentlichen (Kapitel 6); „Mein Bereich“ meldet Änderungen am eigenen Dienstplan (Kapitel 4). Die Datenbank bleibt unverändert.

Update auf 1.18.0: Neu sind das Datenschutz-Paket unter Export und die Datenauskunft je Person unter Mitarbeitende (Kapitel 10). Die Datenbank bleibt unverändert.

Update auf 1.19.0: Die Verwaltung hat links eine einklappbare Seitenleiste statt der Kacheln, am Handy eine Schublade hinter ☰ (Kapitel 5). Die Datenbank bleibt unverändert.

Update auf 1.19.1: Die Seitenleiste ist kompakter und zeigt eingeklappt einen Kurztext unter dem Symbol; „Anträge“ trennt neue Meldungen und offene Anträge, mit Filter-Schaltflächen (Kapitel 5). Die Datenbank bleibt unverändert.

Update auf 1.20.0: Der Reiter „Zeiten“ im Dienstplan zeigt die Woche als Wochenplan mit Zeitleisten je Tag, umschaltbar auf einen Tag (Kapitel 6). Die Datenbank bleibt unverändert.

Update auf 1.21.0: Neu sind E-Mail-Benachrichtigungen (Kapitel 14). Nach dem Update ist E-Mail aus; es geht keine Mail hinaus, bis Admin unter Einstellungen → E-Mail den Mailserver einträgt und die Funktion einschaltet. Die Datenbank bekommt Felder für E-Mail-Adresse und Benachrichtigungen sowie die Warteschlange; vorher legt das Programm automatisch die Sicherung vor-migration-22-….db an. Bestehende Daten bleiben unverändert.

Update auf 1.21.1: Neu ist „Pause eintragen“ in Zeiten / Monat (Kapitel 5). Keine Datenbankänderung, es ist nichts einzustellen.

Update auf 1.21.2: Wartungsversion mit Sicherheitsverbesserungen. Keine Datenbankänderung.

  • Firewall: Die Regel „Zeiterfassung“ gilt nur noch für das lokale Netz. Wird Stundenhüter aus einem anderen Subnetz oder per VPN genutzt, öffne in der Windows-Firewall die Regel „Zeiterfassung“ (Eigenschaften → Bereich → Remote-IP-Adresse) und trage dort die zusätzlichen Netze ein (z. B. das VPN-Netz) – für alle Adressen 0.0.0.0-255.255.255.255, nicht „Beliebige IP-Adresse“. Eine so angepasste Regel bleibt beim Update erhalten; „Beliebige IP-Adresse“ setzt das Update dagegen wieder auf das lokale Netz zurück.
  • Andere Servernamen: Der Server antwortet unter IP-Adresse, localhost, Rechnername und der festen Server-Adresse. Soll er unter einem weiteren Namen erreichbar sein, trage den Namen (mehrere mit Komma) in die Umgebungsvariable ZE_HOSTS ein. Beim Windows-Dienst steht sie in zeiterfassung-service.xml im Programmordner als Zeile <env name="ZE_HOSTS" value="zeit.praxis.de,praxissrv2"/> neben ZE_PORT; danach den Dienst neu starten. Das Update übernimmt diese Zeile.
  • Ordnerrechte: Nach Installation und Update gehören Programm- und Datenordner den Administratoren. Das Setup lehnt Systemordner wie C:\Windows oder C:\Program Files selbst als Zielordner ab.
  • Docker: Der Container läuft nicht mehr als root. Ein bestehendes Volume einmalig übergeben, siehe README (Abschnitt „Docker“); dort steht auch ZE_HOSTS für Namen des Docker-Hosts.

Update auf 1.23.0: Die Oberfläche ist überarbeitet: In der Verwaltung liegt das Kontomenü (Mein Konto, Erscheinungsbild, Info und Neuerungen, Abmelden) jetzt unten links statt in der Kopfleiste, die Einstellungen sind Unterseiten mit eigener Navigation, und Übersicht, Woche und Zeiten / Monat zeigen SOLL und IST. Keine Datenbankänderung; Sicherung und Update laufen wie gewohnt. Am Tablet ändert sich nur die Startseite: Sie zeigt den Arbeitsstatus anderer Personen nicht mehr.

Update auf 1.22.0: Neu sind Zuschläge nach § 3b EStG (Kapitel 15). Nach dem Update ist das Modul „Zuschläge“ aus; Zeiten / Monat, Stundenzettel, Stundenmeldung und DATEV-Export bleiben unverändert, bis Admin es unter Einstellungen → Funktionen einschaltet. Keine Datenbankänderung.

Update auf 1.25.0: Neu sind Tauschen, Abgeben und Wunschfrei im Dienstplan (Kapitel 4 und 6). Tauschen ist nach dem Update ausgeschaltet; Admin schaltet es unter Einstellungen → Selbstbedienung im Dienstplan ein (Kapitel 8), Genehmigen bleibt bei der Verwaltung (Standard; Einstellung „Freigabe“). Wunschfrei steht nach dem Update zur Verfügung (Standard: 2 Tage je Monat, 14 Tage Frist; 0 schaltet es aus). Die Datenbank bekommt Tabellen für Tauschwünsche und Wunschfrei; die Warteschlange der E-Mails wird für die neuen Mail-Arten neu aufgebaut (alle Einträge bleiben erhalten). Vorher legt das Programm automatisch die Sicherung vor-migration-23-….db an. Lief danach doch wieder 1.24.x oder eine ältere Version (etwa nach einem Rückfall beim Update), startet diese mit der Datenbank in Schema 24 weiter und setzt die Schemaversion auf 23. Sie kennt aber keine Tauschwünsche und kein Wunschfrei: Die neuen Tabellen bleiben unberührt liegen, wartende Tausch-Mails sendet sie nicht (sie stehen in „Letzte Sendungen“ als nicht gesendet), und ein Tag, den sie über einen Tausch hinweg veröffentlicht, verliert in 1.25.0 das Kennzeichen „Tausch“. Beim erneuten Update auf 1.25.0 sichert das Programm wieder und ergänzt, was fehlt; offene Tauschwünsche, deren Tage sich inzwischen geändert haben, werden hinfällig. Ein echtes Zurück ohne diese Einschränkungen gibt es nur mit der Sicherung vor-migration-23-… – Buchungen seit dem Update gehen dabei verloren.

Update auf 1.44.0: Neu sind Verfügbarkeit, Kann-Liste und offene Dienste im Dienstplan (Kapitel 4 und 6). Wunschfrei geht in der Verfügbarkeit auf: Die bisherigen Wunschfrei-Tage übernimmt das Update mit Notiz und Antwort; Höchstzahl und Frist bleiben (Kapitel 8). Wochenmuster gibt es erst, wenn die Verwaltung bei einer Person „Plant nach Verfügbarkeit“ einschaltet. Offene Dienste vergibt ab Werk die Verwaltung. Die Datenbank ändert sich (Schema 33); vorher legt das Programm automatisch die Sicherung vor-migration-<alte Schemanummer>-….db an (von 1.41.x aus vor-migration-32-…). Eine ältere Version legt eine leere Wunschfrei-Liste an und sieht die übernommenen Wunschfrei-Tage nicht; Verfügbarkeit, Kann-Liste und offene Dienste kennt sie nicht, und wartende Mails der neuen Arten sendet sie nicht. Zurück ohne Verlust geht es nur mit dieser Sicherung – Buchungen seit dem Update gehen dabei verloren.

Update auf 1.43.0: Neu sind die Linux-Pakete (Abschnitt „Installation unter Linux“) und das zweite Sicherungsziel, z. B. ein USB-Stick (Kapitel 9). Keine Datenbankänderung, unter Windows ist nichts einzustellen.

Update auf 1.41.0: Läuft HTTPS, geht die Verwaltung nur noch über https:// (Abschnitt „HTTPS und Geräte einrichten“) – Verwaltungs-PCs ohne eingerichtete Stelle zeigen sonst eine Zertifikatswarnung. Nach der PIN am Tablet zeigt „Mein Bereich“ den persönlichen Link nicht mehr; ihn gibt die Verwaltung aus (Kapitel 4). Die Datenbank ändert sich (Schema 32, Stempel-Links nur noch als Prüfwert und verschlüsselt); das Update sichert sie vorher als vor-migration-<alte Schemanummer>-….db (ab 1.36 ist das 29). Diese Sicherung und die Kopie backup\vor-update-… enthalten die Links noch im Klartext (Kapitel 9). Bestehende Links und QR-Codes bleiben gültig. Neu im Datenordner ist die Schlüsseldatei link.key (Kapitel 9). Eine ältere Version startet mit der neuen Datenbank nicht richtig; zurück geht es nur mit dieser Sicherung.

Update auf 1.39.0: Neu ist HTTPS (Abschnitt „HTTPS und Geräte einrichten“). Das Update ermittelt den HTTPS-Port (443 oder der erste freie ab 8443), öffnet die Firewall dafür und trägt die neue Zertifizierungsstelle auf dem Server ein. HTTP läuft unverändert weiter; Tablets, Links und QR-Codes funktionieren wie bisher. Richte danach die Geräte ein und schalte erst dann unter Einstellungen → Sicherheit auf „Nur noch HTTPS“ um. Die Datenbank ändert sich nicht. Ein vorhandener HTTPS-Port bleibt, solange er frei ist.

Installation auf dem Mac

Stundenhüter gibt es als Installer für den Mac: macOS 11 oder neuer, auf Apple Silicon und Intel (eine Datei für beide). Der Installer ist von Apple geprüft (Developer ID, notarisiert), es erscheint keine Gatekeeper-Warnung. Der Mac sollte im Haus-Netz stehen und während der Arbeitszeit laufen, am besten mit abgeschaltetem Ruhezustand.

Installieren

  1. Kopiere Stundenhueter-macOS-<Version>.pkg auf den Mac und starte die Datei mit einem Doppelklick.
  2. Klicke Dich mit „Fortfahren“ durch den Installer und gib am Ende das Passwort Deines Mac-Benutzers ein.
  3. Danach öffnet sich der Browser mit http://localhost/admin. Lege dort die erste Admin-Person an; danach startet der Einrichtungs-Assistent (Kapitel 3).

Stundenhüter läuft als Systemdienst, also auch ohne angemeldeten Benutzer, und startet mit dem Mac. Er hört auf Port 80. Im Ordner „Programme“ liegt zusätzlich die App „Stundenhüter“, die die Verwaltung im Browser öffnet. Andere Geräte im Haus-Netz erreichen den Server unter http://<Rechnername>.local/ bzw. http://<IP>/.

Pfad Inhalt
/Library/Application Support/Stundenhueter/Daten Daten: Datenbank, Sicherungen in backup/, config.json
/Library/Logs/Stundenhueter Protokolle des Dienstes
/Applications/Stundenhüter.app App, die die Verwaltung im Browser öffnet

Update

Starte den neuen Installer genauso per Doppelklick. Er sichert vor jedem Update die Datenbank nach Daten/backup/vor-update-….db und setzt dann die neue Version ein. Deine Daten bleiben erhalten.

Port ändern

Der Port steht in der Dienstdatei /Library/LaunchDaemons/de.stundenhueter.server.plist als ZE_PORT. Ändere den Wert (mit Administratorrechten) und starte den Dienst neu:

sudo launchctl kickstart -k system/de.stundenhueter.server

Danach stellst Du Tablets, Lesezeichen und Client-Apps auf die neue Adresse um, wie unter „Port später ändern“ beschrieben. Ein Update übernimmt den eingestellten Port.

Entfernen

Doppelklicke /Library/Application Support/Stundenhueter/Stundenhüter entfernen.command. Das entfernt Dienst und Programm. Die Daten bleiben erhalten, außer Du tippst auf Nachfrage LÖSCHEN.

Installation unter Linux

Stundenhüter gibt es als Paket für Debian 12 und Ubuntu 22.04 oder neuer, jeweils 64 Bit. Am besten läuft es auf einem kleinen Rechner ohne Bildschirm, etwa einem Mini-PC, der im Haus-Netz steht. Am Linux-Desktop im Büro geht es genauso.

Installieren

  1. Kopiere die passende Datei auf den Rechner: stundenhueter_<Version>_amd64.deb für übliche PCs und Server, stundenhueter_<Version>_arm64.deb für ARM-Rechner.

  2. Öffne ein Terminal im Ordner der Datei und gib ein:

    sudo apt install ./stundenhueter_<Version>_amd64.deb
    

    Am Linux-Desktop genügt meist ein Doppelklick auf die Datei.

  3. Das Paket prüft zuerst den Rechner. Unter 1 GB freiem Speicherplatz bricht es ab, unter 2 GB Arbeitsspeicher warnt es nur.

  4. Am Ende steht „Stundenhüter läuft: http://<Rechnername>.local/ bzw. http://<IP>/ – im Browser öffnen und die erste Admin-Person anlegen.“ Öffne die Adresse auf einem Gerät im Haus-Netz und lege die erste Admin-Person an (Kapitel 3).

Stundenhüter läuft als Dienst stundenhueter unter einem eigenen Systemkonto und startet mit dem Rechner. Ist Port 80 belegt, nimmt das Paket Port 8080. Sind beide belegt, bricht es ab. Setze dann einen freien Port mit sudo stundenhueter port <Nummer> und schließe die Einrichtung mit sudo dpkg --configure -a ab.

Die Adresse http://<Rechnername>.local/ funktioniert, wenn auf dem Rechner avahi-daemon läuft. apt installiert ihn normalerweise mit. Sonst nutzt Du die IP-Adresse.

Pfad Inhalt
/var/lib/stundenhueter Daten: Datenbank, Sicherungen in backup/, config.json
/etc/default/stundenhueter Port und weitere Einstellungen
/var/log/stundenhueter Protokolle von Installation, Update und Port-Wechsel
/opt/stundenhueter Programmdateien

Die Meldungen des Dienstes zeigt journalctl -u stundenhueter. Den Datenordner in /etc/default/stundenhueter änderst Du nicht; der Dienst darf nur dort schreiben.

Update

Installiere die neue Datei genauso: sudo apt install ./stundenhueter_<neue Version>_amd64.deb. Das Paket stoppt den Dienst, sichert die Daten nach /var/lib/stundenhueter/backup/vor-update-<alte Version>-<Zeit>/, setzt die neue Version ein und prüft, ob sie antwortet. Antwortet sie nicht, legt es die alte Version zurück, startet sie und meldet einen Fehler mit dem Pfad zur Sicherung. Klappt die Sicherung nicht, bricht es ab, bevor es etwas ändert.

Eine ältere Version lässt sich nicht über eine neuere installieren, wenn die Datenbank schon das neuere Format hat. Das Paket bricht dann ab, bevor es den Dienst stoppt.

HTTPS

Auch unter Linux spricht Stundenhüter zusätzlich HTTPS, Standard ist Port 443 (Abschnitt „HTTPS und Geräte einrichten“). Beim ersten Start legt der Dienst die Zertifizierungsstelle und das Serverzertifikat im Datenordner unter tls/ an. Das Zertifikat gilt für den Rechnernamen, für <Rechnername>.local und für die IP-Adressen des Rechners; ändert sich davon etwas, stellt der Dienst beim nächsten Start ein neues aus.

Die Verwaltung geht nur noch über https://. Richte Verwaltungs-PCs, Tablets und Handys deshalb über die Seite „Geräte einrichten“ ein (http://<Rechnername>.local/einrichten), sonst zeigt der Browser eine Zertifikatswarnung. Den Fingerabdruck der Stelle zum Vergleichen zeigt journalctl -u stundenhueter | grep Fingerabdruck.

Einen anderen HTTPS-Port trägst Du in /etc/default/stundenhueter als ZE_HTTPS_PORT=<Nummer> ein, ZE_HTTPS_PORT=aus schaltet HTTPS ab. Danach sudo systemctl restart stundenhueter.

Befehle

Befehl Wozu
stundenhueter zeigt Version, Dienststatus, Adressen, Port und Datenordner
sudo stundenhueter port <Nummer> ändert den Port, prüft ihn und setzt bei einem Fehler den alten zurück
sudo stundenhueter notfall-admin <Anmeldename> setzt das Passwort einer Person neu und gibt ihr die Rolle Admin
sudo stundenhueter sperren-zuruecksetzen hebt alle Anmeldesperren auf
sudo stundenhueter diagnose schreibt eine Textdatei für den Support in Dein Home-Verzeichnis
sudo stundenhueter reparieren richtet Systemkonto, Rechte und Dienst neu ein und startet ihn

Am Linux-Desktop findest Du im Anwendungsmenü außerdem „Stundenhüter öffnen“, „Stundenhüter – Port ändern“ und „Stundenhüter – Notfall: Admin-Passwort“. Die beiden letzten öffnen ein Terminal und fragen nach Deinem Passwort.

Nach einem Port-Wechsel stellst Du Tablets, Lesezeichen und Client-Apps auf die neue Adresse um, wie unter „Port später ändern“ beschrieben.

USB-Stick für das zweite Sicherungsziel: Er braucht die Bezeichnung SICHERUNG und das Dateisystem exFAT (Kapitel 9). Auf Ubuntu mit schlankem Cloud- bzw. virtuellem Kernel fehlt das exFAT-Modul. Dann hilft sudo apt install linux-modules-extra-$(uname -r). Debian und Raspberry Pi OS bringen es mit.

Fernwartung

Damit der Support Deinen Server betreuen kann, ohne vor Ort zu sein, baut der Server einen verschlüsselten WireGuard-Tunnel zur FRITZ!Box des Supports auf. Am Router Deines Betriebs musst Du dafür nichts freigeben.

  1. Der Support legt in seiner FRITZ!Box unter Internet → Freigaben → VPN (WireGuard) eine Verbindung vom Typ Einzelgerät an und gibt Dir die erzeugte Datei – oder spielt sie selbst ein.
  2. Auf dem Server: sudo stundenhueter fernwartung einrichten <Datei>. Stundenhüter schickt nur Verbindungen ins Netz des Supports durch den Tunnel (Schnittstelle stunden-fern), Dein übriger Internetverkehr bleibt unberührt. Sobald Stundenhüter die Einstellungen übernommen hat, wird Deine Datei gelöscht (sie enthält den privaten Schlüssel), auch wenn die Verbindung noch nicht steht. Fehlt WireGuard, meldet der Befehl das und nennt sudo apt install wireguard-tools.
  3. sudo stundenhueter fernwartung status zeigt, ob der Tunnel steht; sudo stundenhueter fernwartung aus schaltet ihn ab.

Mit Fernwartung kann der Support Personaldaten einsehen. Schließt dafür einen Vertrag zur Auftragsverarbeitung (AVV) ab.

Hat der Anschluss des Supports DS-Lite (häufig bei Kabelanschlüssen), ist er nur über IPv6 erreichbar. Der Anschluss Deines Betriebs braucht dann ebenfalls IPv6 – bei der Telekom ist das Standard.

Überwachung mit Uptime Kuma

Über den Tunnel kann der Support den Server überwachen und wird benachrichtigt, wenn etwas nicht stimmt: App antwortet nicht, Speicherplatz knapp, Sicherung zu alt, USB-Stick fehlt, Rechner zu heiß.

  1. Auf dem Server: sudo stundenhueter status-schluessel. Der Befehl legt einen Zugangsschlüssel an und zeigt Adresse und Kopfzeile. Ohne Schlüssel ist die Statusschnittstelle abgeschaltet (Antwort 404); … status-schluessel aus schaltet sie wieder ab, … status-schluessel neu erzeugt einen neuen Schlüssel. Bei falschem Schlüssel antwortet sie mit 401, bei einem Fehlerzustand mit 503.
  2. In Uptime Kuma (z. B. als Container auf einer Synology) einen Monitor „HTTP(s) – Schlüsselwort“ anlegen: Adresse http://<Tunnel-Adresse>/api/system/status (bei einem Port ungleich 80 mit :<Port>, z. B. :8080; der Befehl zeigt die fertige Adresse an), Kopfzeile Authorization: Bearer <Schlüssel>, Schlüsselwort "zustand":"ok", Intervall 60 Sekunden. Mit dem Schlüsselwort "zustand":"ok" meldet Uptime Kuma auch Warnungen, nicht nur Ausfälle.
  3. Einen zweiten Monitor „Ping“ auf die Tunnel-Adresse anlegen. Schlägt nur der erste an, läuft der Rechner, aber die App nicht.
  4. In Kuma eine Benachrichtigung wählen, z. B. ntfy, Telegram oder E-Mail.

Die Statusschnittstelle enthält keine Personaldaten, nur Version, Laufzeit und Messwerte. Unter Windows legst Du den Schlüssel als Datei status-schluessel (64 Hexadezimalzeichen) im Datenordner an.

Entfernen

  • sudo apt remove stundenhueter stoppt den Dienst und entfernt das Programm. Daten und /etc/default/stundenhueter bleiben. Die Fernwartung bleibt bewusst eingerichtet und aktiv, damit Du Dich bei einer Neuinstallation über den Tunnel nicht aussperrst. Willst Du sie vor dem Entfernen abschalten: sudo stundenhueter fernwartung aus (nach dem Entfernen: sudo systemctl disable --now wg-quick@stunden-fern).
  • sudo apt purge stundenhueter entfernt zusätzlich die Einstellungen und das Systemkonto und beendet die Fernwartung (Tunnel gestoppt, Einrichtung samt Schlüssel gelöscht). Führe purge nicht über eine SSH-Sitzung durch den Tunnel aus: Die Verbindung bricht am Ende ab. Die Daten unter /var/lib/stundenhueter bleiben auch dann erhalten (Aufbewahrungspflicht, Kapitel 10). Löschen kannst Du sie nur von Hand mit sudo rm -r /var/lib/stundenhueter. Mach vorher eine Sicherung (Kapitel 9).

Deinstallation

  1. Öffne in Windows Einstellungen → Apps → Installierte Apps (Server 2022: Apps & Features) und wähle „Stundenhüter“. Alternativ wählst Du im Startmenü Stundenhüter → Deinstallieren.
  2. Folge dem Setup. Es fragt, ob auch die Daten gelöscht werden sollen.
  3. Die Vorgabe ist Nein. Dann bleiben alle Daten erhalten.

Dienst, Firewall-Regel, Startmenü-Ordner und Programmordner werden entfernt. Wählst Du „Daten löschen“, entfernt das Setup auch die Zertifizierungsstelle aus dem Zertifikatsspeicher des Servers. Sollen die Daten wirklich weg, lies vorher Kapitel 10 zu den Aufbewahrungsfristen und mache eine Sicherung (Kapitel 9).

Herausgegeben von Softblade GmbH, 91056 Erlangen · Stand: Version 1.93.0 · Fragen an contact@softblade.de · Impressum