Support

Quick answers

Tracking isn't working

1. Confirm location permission is granted (system Settings → With Tracker → Location → Allow always, or While using the app if you only track in the foreground).
2. On Android 13+, confirm notification permission is granted — the foreground service needs it.
3. Confirm at least one Connection is enabled and within its time window. Tracking with no active Connections runs foreground-only and stops when you background the app.
4. Check the Connections screen — a red dot and error message next to a Connection means POSTs are failing (wrong URL, bad token, or the endpoint is down).

My endpoint isn't receiving points

• Verify the URL is reachable from another client (e.g. curl).
• Confirm the request body matches the wire format.
• If you use a bearer token, confirm it is valid and not expired.
• The App sends each point fire-and-forget — a failed POST is not retried. If your endpoint was briefly down, points produced during that window are lost.

Battery drain

With Tracker uses a ~300m distance filter and motion detection, so GPS sleeps while you're stationary. If you see higher drain than expected, check whether another app is also tracking, and whether you have many active Connections (each point is POSTed to every active Connection).

I forgot my webhook token

Tokens are stored only on your device. If you lost the token, regenerate it at your endpoint and update the Connection in the App. We cannot recover it for you — we never had it.

Importing a connection

You can add a Connection in three ways:

1. Manual entry — tap the + button on the Connections screen and fill in the form.
2. Config file — tap Import from file in the Connection form and pick a JSON file matching the config schema.
3. Deep link — open a withtracker://connection?c=<base64-JSON> link. The form opens pre-filled; you review and confirm before anything is saved.

Reporting a bug

Email oscar@goeaglelogistics.com with the following:

• App version and build number (About screen → APP).
• Device model and OS version.
• Whether tracking was foreground or background.
• The exact error message if a Connection shows a red status.
• Steps to reproduce.

Do not paste your bearer token or webhook URL into the email. Replace them with placeholders.

Contact

• Bug reports & feature requests: oscar@goeaglelogistics.com
• Privacy questions: oscar@goeaglelogistics.com