> For the complete documentation index, see [llms.txt](https://docs.chirpwireless.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chirpwireless.io/connectors/tracker-connector.md).

# Tracker Connector

Connect a cellular GPS vehicle tracker to Chirp — OBD2, CAN bus, and standalone trackers, 2,000+ preconfigured models.

Chirp goes beyond the walls of your home. The **Tracker connector** lets you bring a **vehicle GPS tracker** into Chirp, so your car, motorcycle, or camper shows up on the same dashboards and alerts as your sensors — live location, route history, speed, and whatever else the tracker reports.

<figure><img src="https://1153890212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxgYoHO4zlaBzHJcfIrto%2Fuploads%2Fgit-blob-7d05dee62a2965a7d2787758ed08315cd3d34741%2Ftracker-connector.jpg?alt=media" alt="Add connector dialog with Tracker selected as the connector type"><figcaption></figcaption></figure>

## What it's for

The Tracker connector is for **cellular (GSM) vehicle trackers** — devices that send their location over the mobile network:

* **OBD2** plug-in trackers (into a car's diagnostics port)
* **CAN bus** trackers wired into the vehicle
* **Standalone GPS** vehicle trackers

Chirp ships with preconfigured profiles for **over 2,000 tracker models**, so most popular trackers work out of the box.

These trackers almost always need an external power source or a vehicle connection (OBD2/CAN), which makes them a great fit for **cars, motorcycles, campers, trailers with a battery, boats, ATVs**, and similar — not for tiny battery-only room sensors.

> **Cellular trackers only — not LoRaWAN.** Some GPS trackers and tags use LoRaWAN instead of a mobile network. Those do **not** go through the Tracker connector — a LoRaWAN tracker connects through the [LNS Connector](https://docs.chirpwireless.io/connectors/lns-connector.md), just like your other LoRaWAN sensors. Use the Tracker connector for cellular/GSM vehicle trackers.

## Adding the Tracker connector

1. Click **Connectors** in the sidebar.
2. Click **Add connector**.
3. Choose **Tracker** from the **Connector type** dropdown.
4. Click **Add**.

That's it — the connector is created in one step. Each home can have **one Tracker connector**. (See [Setting Up a Connection](https://docs.chirpwireless.io/connectors/setting-up-a-connection.md) for the connection basics.)

## Connecting your tracker

When you register a tracker through this connector, its **Connection** details include three tracker-specific fields:

* **Unique ID** — your tracker's identifier
* **Device model** — pick your tracker from the model list
* **Url for GPS tracker** — the endpoint Chirp gives you; configure your tracker (in its own app or SMS settings) to send data to this URL

Configure the tracker to send its data to that URL; once it starts reporting, it appears in Chirp. For the full registration walkthrough, see [Adding Sensors](https://docs.chirpwireless.io/devices/adding-sensors.md).

## Seeing where it's been

Name the digital device for the car, such as **Family Car**, and map its location readings. Add a dashboard Map widget to see its last known position and select a history range. See [Tracking What Matters](https://docs.chirpwireless.io/dashboards/tracking-what-matters.md).

If the tracker fails, replace its connection on the same digital device and reconnect its existing measurements. Keeping those measurements lets the car retain its earlier location history. Follow [Replace your car's tracker](https://docs.chirpwireless.io/devices/sensor-details.md#how-do-i-replace-my-cars-tracker).
