Konfiguration
Alle Einstellungen einer Installation stehen in der Datei .env im Installationsordner. Nach einer Änderung übernehmen Sie sie mit:
docker compose up -d
Einstellungen, die einzelne Firmen betreffen (Pausenregeln, Urlaub, Funktionen, Löschfristen …), werden dagegen in der App unter Firma gepflegt.
Pflichtangaben
| Variable |
Bedeutung |
PUNCHIFY_DOMAIN |
Adresse, unter der Punchify erreichbar ist, z. B. zeit.ihrefirma.de. Der DNS-Eintrag muss auf den Server zeigen. |
ACME_EMAIL |
E-Mail-Adresse für Hinweise von Let's Encrypt (z. B. zu ablaufenden Zertifikaten). |
PUNCHIFY_LICENSE_KEY |
Ihr Lizenzschlüssel (beginnt mit PUNCHIFY1.). Siehe Lizenz. |
PUNCHIFY_DB_PASSWORD |
Passwort der Datenbank – ein langer Zufallswert. Nach dem ersten Start nicht mehr ändern. |
PUNCHIFY_SECRET_KEY |
Geheimer Schlüssel (mind. 16 Zeichen, besser 64 Hex-Zeichen). Verschlüsselt die Sicherungen und – falls eingeschaltet – sensible Felder. Gut aufbewahren. |
PUNCHIFY_ADMIN_EMAIL |
E-Mail des ersten Admins. Wird nur beim allerersten Start angelegt. |
PUNCHIFY_ADMIN_PASSWORD |
Erstes Passwort dieses Admins (mind. 8 Zeichen). Danach in der App ändern und hier entfernen. |
Instanz
| Variable |
Standard |
Bedeutung |
PUNCHIFY_COMPANY_NAME |
Meine Firma |
Name der ersten Firma. Weitere Firmen legt der Super-Admin in der App an. |
PUNCHIFY_INSTANCE_NAME |
Punchify |
Name oben in der App und im Absender von E-Mails. |
PUNCHIFY_TIMEZONE |
Europe/Berlin |
Zeitzone für Tagesgrenzen, Anzeige und nächtliche Aufgaben. |
PUNCHIFY_SESSION_DAYS |
30 |
Wie lange eine Anmeldung gültig bleibt (Tage). |
PUNCHIFY_VERSION |
latest |
Welche Version Docker lädt – latest oder eine feste Nummer wie 0.10.0. |
E-Mail (optional)
Ohne diese Angaben verschickt Punchify keine E-Mails; alles andere funktioniert. Benachrichtigungen gibt es dann nur als Push auf installierte Apps.
| Variable |
Bedeutung |
PUNCHIFY_SMTP_HOST |
SMTP-Server Ihres E-Mail-Anbieters. |
PUNCHIFY_SMTP_PORT |
587 (STARTTLS) oder 465 (SSL). |
PUNCHIFY_SMTP_USER / PUNCHIFY_SMTP_PASSWORD |
Zugangsdaten des Postfachs. |
PUNCHIFY_MAIL_FROM |
Absenderadresse, z. B. zeit@ihrefirma.de. |
Datenschutz und Sicherheit (optional)
| Variable |
Standard |
Bedeutung |
PUNCHIFY_FIELD_ENCRYPTION |
0 |
1 = sensible Felder (Notizen, Schutzregeln, Verlauf, Protokoll) zusätzlich verschlüsselt speichern. Schlüssel ist PUNCHIFY_SECRET_KEY. Wird beim nächsten Start umgestellt. |
PUNCHIFY_IP_ALLOWLIST_OFF |
0 |
Notschalter: 1 ignoriert die IP-Allowlists aller Firmen – falls sich eine Firma ausgesperrt hat. Danach wieder auf 0. |
PUNCHIFY_TRUSTED_PROXIES |
private Netze |
Adressen, deren X-Forwarded-For geglaubt wird. Nur ändern, wenn ein anderer Proxy vor Caddy steht. |
PUNCHIFY_WEBHOOK_ALLOW_PRIVATE |
0 |
1 erlaubt Webhooks an interne Adressen (nur in eigenen Netzen sinnvoll). |
Kiosk (optional)
| Variable |
Bedeutung |
PUNCHIFY_KIOSK_HOST |
Eigene Adresse für Kiosk-Geräte, z. B. kiosk.zeit.ihrefirma.de. Unter dieser Adresse ist nur der Kiosk erreichbar. Im Caddyfile den vorbereiteten Kiosk-Block einkommentieren. Siehe Kiosk. |
Sicherungen und Weiteres (optional)
| Variable |
Standard |
Bedeutung |
PUNCHIFY_BACKUPS |
1 |
0 schaltet die nächtliche Sicherung ab (nicht empfohlen). |
PUNCHIFY_BACKUP_KEEP |
14 |
Wie viele Sicherungen aufbewahrt werden. |
PUNCHIFY_PUSH |
1 |
0 schaltet Push-Benachrichtigungen ab. |
PUNCHIFY_DOCS_URL |
https://wiki.punchify.app |
Ziel der Hilfe-Links in der Oberfläche, z. B. für eine eigene Kopie der Dokumentation im Intranet. |
Weitere Variablen (PUNCHIFY_DATABASE_URL, PUNCHIFY_DATA_DIR, PUNCHIFY_DEMO_MODE, PUNCHIFY_SECURE_COOKIES, PUNCHIFY_LICENSE_SERVER) sind für Entwicklung und Sonderfälle gedacht und müssen bei einer normalen Installation nicht gesetzt werden.