BASIC DEVICE CONNECTION TROUBLESHOOTING GUIDE

BASIC DEVICE CONNECTION TROUBLESHOOTING GUIDE

When a GPS tracking device is not showing data or appearing offline, use the following steps to perform basic troubleshooting. This can help identify and resolve common connection issues quickly.

1. โœ… Confirm Device is Powered and Installed Correctly

  • Ensure the device is securely connected to a power source.

  • For vehicle devices, verify ignition is on (if applicable).

  • Check for visible LED indicators (power/GPS/GSM) and refer to the device manual for status meanings.

2. ๐ŸŒ Check Network Connectivity

  • Make sure the device has a working SIM card installed.

  • Ensure the SIM card has:

    • Data enabled.

    • Sufficient airtime or an active data plan.

    • No PIN lock.

  • The device should have GSM signal. Some models show signal strength via LEDs.

3. ๐ŸŒ Verify Server and Port Configuration

  • Production Server: data.gpsiot.net

  • Troubleshooting Server (if not reporting): tiny.gpsiot.net

  • Port: This must match the port assigned to your specific device brand/model. You can find the correct port here:
    ๐Ÿ”— Supported Hardware and Ports

Example: Teltonika devices often use port 12070

Check that your device is configured with:

  • The correct APN (provided by your SIM carrier).

  • Server set to data.gpsiot.net (or tiny.gpsiot.net temporarily for troubleshooting).

  • The correct port number (as per device model).

  • Make sure the device is using TCP as the transmission protocol, not UDP.

Tip: If the device is not reporting to data.gpsiot.net, reconfigure it to tiny.gpsiot.net using the same port. This server is often used to quickly test whether the device can connect and send data.

4. ๐Ÿ› ๏ธ Use SMS or Platform Tools to Query Device

  • Most devices accept SMS commands to return current settings (e.g., APN, server, port).

  • Use these to confirm if the device is pointing to the correct server and port.

5. ๐Ÿ“ˆ Wait for First Fix

  • Devices may take a few minutes after power-up to obtain a GPS fix and begin transmitting.

  • Ensure the device has clear access to the sky for GPS signal.

6. ๐Ÿงช Cross-check with Platform

  • On our tracking platform, confirm the device IMEI or ID is correctly added.

  • Check telemetry logs or incoming data if available.

7. ๐Ÿ“ž Still Not Working?

If all settings are correct and the device is still offline:

  • Restart the device.

  • Try swapping the SIM card with a known working one.

  • Contact support@whitelabeltracking.com with:

    • Device model and IMEI/Device ID.

    • SIM card details (carrier, data status).

    • Current device settings (APN, server, port).


This general guide addresses most common/initial connection issues. For more advanced troubleshooting, please consult the device manufacturer and provide complete logs and configuration details.

    • Related Articles

    • Assigning asset and Simcard to a device

      In order to assign an asset to a device, click on admin> client> devices and select the required device then assign/set the asset and the SIM card for the device.
    • Add devices using the batch import

      Guide to using the Batch Import You can choose to upload a batch of devices at once to your client account lather than use the Add Asset Wizard which done one device after the other. Preliminaries a. Group all your devices according to client ...
    • Adding a GPS Tracking device

      Your GPS tracker needs the correct settings to show online on our platform Before you begin, make sure you have: SIM card APN settings Device make, model, and identifier (usually the IMEI) SMS commands to configure the device for our platform A ...
    • My device has stopped reporting

      Troubleshooting when your device has stopped reporting You may encounter times when some of your devices simply stop working, having previously been working fine. We have seen customers do nothing, and the device reports on its own accord, other ...
    • Device quarantined, fair use policy quota exceeded - why do I see this message?

      Summary. Something isn’t quite right — your device is sending an excessive amount of data. To protect system performance, we have temporarily quarantined your device. At 00:00 UTC (midnight), the daily quota resets and we will resume saving your ...