Traccar Client Troubleshooting

If you have problems connecting the Traccar Client app to the server, please follow the steps below.

1 Check status screen

Check the status screen in the Traccar Client app:

  • If you don't see "location update" messages, proceed to point 2.
  • If you see "send error" messages, proceed to point 3.
  • If you see location updates without errors, but no data on your server, it might mean that your device is configured with the wrong server. Check app configuration.

If the application stops working after some time, check point 6.

2 Check accuracy parameter

If you don't see "location update" messages, it means that the operating system doesn't provide the app with location information.

  • If accuracy in the app is set to medium or low, check point 4.
  • If accuracy in the app is set to high, check point 5.
3 Check network and server

If you get "send error" messages, it means that the server is not accessible or it doesn't accept your message. Possible reasons:

  • Your device id is not registered on the server. Make sure you use the correct id on the server.
  • Network connection issues on your mobile device. Check network connectivity.
  • Wrong server URL details. Double-check app configuration.
  • Some other server issue. Try server troubleshooting guide.
4 Check network location provider

When medium (default) or low accuracy is selected in the app, it uses the network location provider, which determines location based on cell towers and Wi-Fi access points around the device. Possible reasons for no location update:

  • Network location provider requires internet access. Check network connectivity.
  • Application doesn't have required permissions. Check system settings.
  • Location services are disabled completely. Check system settings.
  • On Android check that network location provider is enabled in system settings.
5 Check GPS location provider

When high accuracy is selected in the app, it uses the GPS location provider, which determines location based on signal from GPS satellites. Possible reasons for no location update:

  • No GPS signal. Remember that a GPS fix takes time and only works with clear sky visibility. GPS does not work indoors.
  • Application doesn't have required permissions. Check system settings.
  • Location services are disabled completely. Check system settings.
  • On Android check that GPS location provider is enabled in system settings.
6 Common background issues

Both Apple and Google are trying to restrict background processes to give users better battery life, but it affects applications like Traccar Client, which require persistent background execution. Common issues to check for:

  • On iOS, if you swipe the app off the screen, the operating system actually kills the process, and the app will no longer be able to report.
  • Make sure that in iOS settings background execution is allowed and Traccar Client has permission to always access location services.
  • On recent versions of Android make sure that you have added Traccar Client to battery optimization exceptions.
  • Some Android vendors have their own battery optimization in addition to the standard Android system. Make sure those are disabled or the app is added to exceptions.
  • Check the Don't Kill My App website for more vendor-specific details.

If you still have issues, please collect operating system logs.