NEVARODocs Support
Hilfe

Troubleshooting

Probleme schnell finden und lösen.

Anmeldung

Anmeldung funktioniert nicht

NEVARO läuft über HTTP (ohne TLS).

Lösung

In der .env COOKIE_SECURE=false setzen, dann neu starten:

Shell
$ docker compose up -d

Installation & Betrieb

Backend startet nicht

Meist ein Fehler bei der Datenbank-Migration.

Lösung

Den Migrationsfehler anzeigen:

Shell
$ docker compose logs db_init

Start bricht beim Laden der Images ab

500 Internal Server Error oder Timeout von der Registry – ein Aussetzer dort, kein Fehler in NEVARO. Das Installationsskript wiederholt das Laden dreimal.

Lösung

Im NEVARO-Ordner noch einmal laden und starten:

Shell
$ docker compose pull
$ docker compose up -d

Permission denied (publickey)

Nur bei einer Installation direkt von GitHub (alter Weg) – beim Klonen oder Auto-Update: der SSH-Schlüssel liegt im ~/.ssh eines anderen Benutzers (z. B. als root installiert, als normaler Benutzer gestartet). Das Update nutzt den Ordner aus SSH_DEPLOY_KEY_DIR, ohne Angabe das ~/.ssh dessen, der docker compose startet.

Lösung

In der .env den Ordner mit dem freigeschalteten Schlüssel fest eintragen und neu starten:

Shell
SSH_DEPLOY_KEY_DIR=/home/<benutzer>/.ssh
Shell
$ docker compose up -d

App lädt, API meldet 502

Lösung
Shell
$ docker compose restart frontend

Updates

Update schlägt fehl

Lokale Änderungen im NEVARO-Ordner (Checkout).

Lösung

git status prüfen und bereinigen.

Integrationen

„Image … konnte nicht geladen werden“

Garmin

Der Server hat kein Internet oder hängt im Docker-Hub-Limit.

Lösung

Den in der Meldung genannten docker pull von Hand ausführen.

„Docker-Socket nicht erreichbar“

Garmin

/var/run/docker.sock fehlt beim Backend in docker-compose.yml.

Lösung

Den Socket dort beim Backend wieder eintragen.

Abruf scheitert mit „Garmin-Token“

Garmin
Lösung

Verbindung trennen und neu verbinden – es geht nichts verloren.

redirect_uri_mismatch

Google Health

Die Redirect-URI bei Google und in NEVARO weichen ab.

Lösung

Beide Einträge Zeichen für Zeichen angleichen.

„noch nicht bei Google Health eingerichtet“

Google Health

Das Google-Konto hat kein Google-Health-Profil.

Lösung

Die Uhr in der Fitbit-/Google-Health-App mit genau diesem Konto einrichten.

Nach Google ist localhost nicht erreichbar

Google Health

Die Verbindung hat geklappt – nur die Rückleitung zeigt auf die falsche Adresse.

Lösung

NEVARO unter der richtigen Adresse öffnen (ab v0.0.0238 automatisch richtig).

„Standort-Freigabe fehlt“ bei den Strecken

Google Health

Google hat die Standort-Freigabe nicht erteilt – sie fehlt unter Datenzugriff oder wurde im Google-Dialog abgewählt.

Lösung

googlehealth.location.readonly unter Datenzugriff eintragen, auf der Google-Karte Neu verbinden und den Haken beim Standort setzen. Alle anderen Daten laufen bis dahin normal weiter.

redirect_uri invalid

Strava

Die Authorization Callback Domain passt nicht.

Lösung

Dort nur den Host eintragen – ohne https:// und ohne Pfad.

Zweiter Nutzer kann sich nicht verbinden

Strava

Die Strava-App ist noch im Single Player Mode.

Lösung

Das Kontingent der App auf 10 Athleten anheben.