Fehlerbehebung
Diese Seite behandelt die häufigsten Probleme bei selbst gehosteten Gäld-Installationen und wie man sie behebt. Für die Cloud-Version (EE) kontaktieren Sie den Support, falls ein Problem nach Ausführung dieser Schritte weiterhin besteht.
Queue-Worker verarbeitet keine Aufgaben
Symptome: Wiederkehrende Rechnungen werden nicht generiert, Erinnerungs-E-Mails nicht gesendet, Treuhänder-Export bleibt hängen.
Ursache: Der Queue-Worker (Laravel Horizon oder der queue:work-Prozess) läuft nicht.
Behebung:
# Status prüfen
sudo systemctl status gaeld-worker
# Worker neu starten
sudo systemctl restart gaeld-worker
# Aktuelle Fehler anzeigen
php artisan queue:failed
Falls fehlgeschlagene Aufgaben vorhanden sind, Wiederholung starten:
php artisan queue:retry all
Um die Liste der fehlgeschlagenen Aufgaben nach Behebung des Problems zu leeren:
php artisan queue:flush
Siehe Self-Hosting für die vollständige systemd-Service-Konfiguration.
MeiliSearch nicht verfügbar / Suche liefert keine Ergebnisse
Symptome: Kontakte, Rechnungen oder Ausgaben können über die Suchleiste nicht gefunden werden; Fehlermeldung „Suche nicht verfügbar".
Ursache: MeiliSearch läuft nicht oder der Index wurde nicht aufgebaut.
Behebung:
# MeiliSearch-Status prüfen
sudo systemctl status meilisearch
# MeiliSearch neu starten
sudo systemctl restart meilisearch
# Alle Daten neu indexieren (im Anwendungsverzeichnis ausführen)
php artisan scout:import "App\Domains\Invoicing\Models\Invoice"
php artisan scout:import "App\Domains\Contacts\Models\Contact"
php artisan scout:import "App\Domains\Expenses\Models\Expense"
Falls MeiliSearch nicht verfügbar ist, schaltet Gäld automatisch auf die Datenbanksuche um. Die Ergebnisse sind möglicherweise langsamer und weniger unscharf, aber die Anwendung funktioniert weiter.
CAMT.053-Import schlägt fehl oder importiert keine Transaktionen
Symptome: Das Hochladen eines Kontoauszugs erzeugt einen Fehler oder importiert 0 Transaktionen.
Häufige Ursachen und Behebung:
| Ursache | Behebung |
|---|---|
| Datei ist kein gültiges CAMT.053-XML | Prüfen Sie die Dateierweiterung und bestätigen Sie, dass Ihre Bank CAMT.053 exportiert, nicht CAMT.054 oder MT940 |
| Datei enthält Transaktionen für eine andere IBAN | Fügen Sie diese IBAN als Bankkonto in Einstellungen → Bankkonten hinzu und importieren Sie erneut |
| Datei wurde bereits importiert | Gäld erkennt Duplikate anhand des Datei-Hash — laden Sie einen neuen Export von Ihrer Bank mit einem anderen Datumsbereich herunter |
| XML ist fehlerhaft | Öffnen Sie die Datei in einem Texteditor und prüfen Sie, ob sie mit <?xml beginnt und <Document> enthält |
Falls der Fehler bestehen bleibt, speichern Sie die Datei und kontaktieren Sie den Support — fügen Sie die von Gäld angezeigte Fehlermeldung bei.
Rechnungs-PDF wird nicht generiert / Download ist leer
Symptome: Klick auf PDF herunterladen bei einer abgeschlossenen Rechnung erzeugt eine leere Seite oder einen Fehler.
Ursache: Meist ein TCPDF-Konfigurationsproblem oder eine fehlende Schriftart.
Behebung:
- Prüfen Sie das Anwendungslog auf PDF-Fehler:
tail -n 50 storage/logs/laravel.log | grep -i pdf
- Stellen Sie sicher, dass das
storage/-Verzeichnis beschreibbar ist:
chmod -R 775 storage/
chown -R www-data:www-data storage/
- Führen Sie die Post-Installations-Artisan-Befehle aus:
php artisan storage:link
php artisan config:clear
php artisan cache:clear
E-Mails werden nicht gesendet (Einladungen, Erinnerungen, Lohnabrechnungen)
Symptome: Eingeladene Benutzer erhalten keine Einladungs-E-Mails; Zahlungserinnerungen werden nicht zugestellt.
Ursache: Die Mail-Konfiguration ist fehlerhaft oder der Queue-Worker läuft nicht.
Behebung:
- Prüfen Sie Einstellungen → E-Mail für Ihre SMTP-Konfiguration (Host, Port, Benutzername, Passwort, Verschlüsselung)
- Klicken Sie auf Test-E-Mail senden, um die Verbindung zu prüfen
- Prüfen Sie, ob der Queue-Worker läuft (siehe oben)
- Prüfen Sie
storage/logs/laravel.logauf SMTP-Fehler:
grep -i "swift\|smtp\|mail" storage/logs/laravel.log | tail -20
Häufige SMTP-Einstellungen für Schweizer Anbieter:
| Anbieter | Host | Port | Verschlüsselung |
|---|---|---|---|
| Infomaniak | mail.infomaniak.com | 587 | STARTTLS |
| Hostpoint | mail.hostpoint.ch | 587 | STARTTLS |
| GMX | mail.gmx.net | 587 | STARTTLS |
| Mailgun | smtp.mailgun.org | 587 | STARTTLS |
„Diese Anmeldedaten stimmen nicht überein" beim Login
Symptome: Login nicht möglich trotz korrekter E-Mail und Passwort.
Mögliche Ursachen:
- Das Passwort wurde von einem anderen Admin geändert
- 2FA ist aktiviert und Sie geben den TOTP-Code nicht ein
- Das Konto ist auf der Subdomain einer anderen Organisation
Behebung:
- Verwenden Sie Passwort vergessen auf der Login-Seite
- Falls 2FA das Problem ist und Sie Ihr Gerät verloren haben, verwenden Sie einen Wiederherstellungscode (bei der 2FA-Einrichtung ausgegeben)
- Falls keine Wiederherstellungscodes vorhanden sind, muss Ihr Organisations-Eigentümer die 2FA für Ihr Konto unter Einstellungen → Benutzer → [Ihr Name] → 2FA deaktivieren deaktivieren
Jahresabschluss ist ausgegraut / nicht verfügbar
Symptome: Die Schaltfläche Jahresabschluss in Buchhaltung ist nicht klickbar.
Ursache: Eine oder mehrere Voraussetzungen sind nicht erfüllt. Gäld verlangt:
- Keine nicht abgeglichenen Banktransaktionen für das Geschäftsjahr
- Keine Rechnungen im Status Entwurf mit einem Datum im Geschäftsjahr
- Der aktuelle Benutzer hat die Rolle Eigentümer oder Admin
Behebung:
- Gehen Sie zu Banking → Abgleich und bereinigen Sie alle nicht abgeglichenen Positionen
- Gehen Sie zu Rechnungen und schliessen oder stornieren Sie alle Entwürfe mit einem Datum im Abschlussjahr
- Prüfen Sie Ihre Rolle unter Einstellungen → Benutzer
Artisan-Befehle (Self-Hosting-Kurzreferenz)
# Alle Caches leeren
php artisan optimize:clear
# Migrationen erneut ausführen (sicher mehrfach ausführbar)
php artisan migrate
# Anwendungsstatus prüfen
php artisan about
# Suche neu indexieren
php artisan scout:import "App\Domains\Invoicing\Models\Invoice"