Skip to main content
Version: Current

FAQ

Frequently asked questions about the server, the web dashboard and the Android app. Problems with a known cause and workaround are listed under Known issues.

Sync and recording​

Why is a trip marked "Pending" or "Sync failed" in the app?​

In the German app these are Ausstehend and Sync fehlgeschlagen.

Trips are recorded on the device first and uploaded in the background as soon as there is a network connection; the app retries at the latest about every 15 minutes. Pending means the upload has not happened yet, for example because the phone is offline or you are signed out. Sync failed means the server rejected the trip; the reason is in the app log (Logcat, tag FahrtenbuchSync). The data stays on the phone in both cases. If the log shows 409 … TRACKING_ALREADY_ACTIVE, see Known issues.

Can I record two trips at the same time?​

No. Each account can have only one running recording at a time, across all devices and the web dashboard. Finish the running trip before starting a new one.

Passkeys​

Why is there no "Passkeys" entry in the app settings?​

The entry only appears if both the server and the phone support passkeys: the server must offer passkeys (PASSKEYS_ENABLED), and the phone needs Android 14 or Google Play services. Before the check has finished, the entry stays hidden.

My password manager says "This app does not support passkeys"​

Password managers such as Bitwarden check through Google's Digital Asset Links service whether the app may use passkeys for your server's domain. Make sure that

  • the server runs a current version (it serves /.well-known/assetlinks.json for the official app),
  • https://<WEBAUTHN_RP_ID>/.well-known/assetlinks.json is publicly reachable over HTTPS without redirects and returns JSON, not the dashboard page,
  • for self-built APKs the signing certificate is added via ANDROID_APP_CERT_SHA256.

Details are in the configuration. After a fix, Google may cache the old result for about 10 minutes.

Web dashboard and server​

Why is there no "Costs" page?​

Vehicle costs are a preview feature and only enabled in the :dev image. In :latest the page is hidden unless the administrator sets FEATURE_EXPENSES=true.

Why can't I invite someone by e-mail to share a vehicle?​

Invitations by e-mail need SMTP on the server and are hidden without it. They also only work for users who already have an account on the server. Use a sharing link instead, or ask the administrator to create the account first. See sharing.

The server does not send reset e-mails through SMTP; it calls PASSWORD_RESET_WEBHOOK_URL. Without that webhook no link is delivered. An administrator can set a new password in Administration › User management. See password reset.

The map shows a wrong road route for a trip​

Switch to Original route in the trip details to see the raw GPS track; the GPS points are never changed by map matching. Correct the trip in the trip editor, or switch map matching off in your profile. Administrators can re-check existing trips with Re-match all trips under Administration › Background jobs.

There is a gap in a trip because the phone stopped recording​

If you use Dawarich, connect it in your profile and use Fill gaps from Dawarich in the trip details. Otherwise add points in the trip editor. To prevent gaps, set the app's battery usage to Unrestricted (see battery optimization).