All posts
TraccarTeltonikaGPS trackers

Connecting Teltonika GPS trackers to Traccar, step by step

Nov 13, 20265 min read

Teltonika trackers, especially the FMB series (FMB920, FMB120, FMB130, FMB140 and friends), are some of the most popular devices on Traccar servers. They're reliable, well documented, and Traccar supports their protocol fully.

Getting the first one connected still trips people up. This guide covers the whole path: preparing Traccar, configuring the tracker with the Configurator or by SMS, and fixing a device that doesn't appear.

How it fits together

  1. The tracker gets mobile data through its SIM card (that needs the right APN).
  2. It opens a connection to your server's address on port 5027, Traccar's default port for the Teltonika protocol.
  3. Traccar identifies the device by its IMEI and stores positions under the matching device.

If any of those three steps fails, the device won't show up. Most problems are one of them.

1. Prepare Traccar

Open the port. Traccar listens for Teltonika on port 5027 by default, for both TCP and UDP. Make sure the firewall allows it:

sudo ufw allow 5027

If your server is with a cloud provider, also check their firewall or security group.

Add the device. In the Traccar web interface, go to Devices → +:

  • Name: something useful, e.g. a vehicle registration
  • Identifier: the tracker's 15-digit IMEI, printed on the label and the box

The identifier must match exactly. This is the most common reason a Teltonika device "doesn't connect".

2. Configure the tracker with the Teltonika Configurator

Connect the tracker to a Windows PC by USB and open the Teltonika Configurator (download it from the Teltonika wiki for your model). Then:

GPRS settings

  • APN: your SIM provider's data APN, plus username and password if the provider uses them
  • Server settings: Domain = your Traccar server's domain or IP; Port = 5027; Protocol = TCP (recommended)

Data acquisition (how often it records positions)

Teltonika has separate settings for when the vehicle is moving and when it's stopped:

Setting On moving (typical) On stop (typical)
Min period 30–60 s 300–3600 s
Min distance 100–200 m –
Min angle 10–20° –
Min saved records 1 1
Send period 30–60 s 300–3600 s

The angle setting gives clean corners on the map without recording too often on straight roads. Smaller values mean smoother tracks but more data use.

Click Save to device, unplug, and power the tracker from the vehicle or its battery.

3. Or configure it by SMS

Without a PC, you can send settings by SMS from your phone. FMB devices accept setparam commands. If no SMS login and password are set on the device, the message starts with two spaces.

Common parameter IDs on FMB devices:

ID Setting
2001 APN
2002 APN username
2003 APN password
2004 Server domain or IP
2005 Server port
2006 Protocol (0 = TCP, 1 = UDP)

Example, all in one message (note the two leading spaces):

  setparam 2001:internet;2004:track.example.com;2005:5027;2006:0

Replace internet with your provider's APN. The tracker replies by SMS to confirm. Check the parameter list for your exact model on the Teltonika wiki, since IDs can differ between product families.

Useful status commands:

  getstatus
  getgps

getstatus shows the data connection state, and getgps shows whether the GPS has a fix.

4. Check it's working

Within a few minutes, the device should turn online in Traccar and show a position. If it doesn't, check Traccar's log while the tracker is powered on:

sudo tail -f /opt/traccar/logs/tracker-server.log | grep -i teltonika

What you'll see tells you which step is failing:

What the log shows Meaning Fix
Unknown device - IMEI ... Data is arriving, but the IMEI doesn't match a device Add or correct the device identifier in Traccar
Connections from the device, but no positions The device is connected but has no GPS fix Move it outdoors with a clear view of the sky, check the GPS antenna side faces up
Nothing at all The tracker can't reach your server Check APN, SIM data balance, server address, port and firewall

Also check that the SIM card has an active data plan, and isn't PIN-locked.

5. Make use of the extra data

Teltonika devices send much more than positions: ignition state, movement, external power voltage, battery voltage, GSM signal and any I/O you've enabled. Traccar stores these as position attributes. Common ones get friendly names (for example ignition and power), others appear as io followed by the element ID.

With ignition data you can:

  • Get ignition on/off notifications
  • Build trip and stop reports from ignition instead of movement alone
  • Track engine hours

Enable the I/O elements you need in the Configurator's I/O section, and choose which ones trigger a record.

Summary

  1. Open port 5027 and add the device with its exact IMEI.
  2. Set the APN, server and port in the Configurator or by SMS.
  3. Tune the data acquisition settings for moving and stopped.
  4. Use the Traccar log to find which step fails.
  5. Turn on ignition and other I/O for better reports and alerts.

Connecting a whole fleet, or a mix of tracker brands? My Traccar installation and setup service includes getting your first devices online.

Keep reading

Need help with your Traccar server?

I offer Traccar setup and maintenance, GPS tracking apps and Flutter development.