Home Assistant Traccar Device Tracker Integration

This package enables the integration of Home Assistant device_tracker entities into the Traccar GPS tracking system by synchronizing device IDs across both platforms. If you like this project you can support me with ☕ , with GitHub Sponsor or simply put a ⭐ to this repository 😊

Table of Contents

1. Requirements
2. Installation
   • Step 1: Configure Traccar Device
   • Step 2: Import YAML File
   • Step 3: Configure Traccar Server IP
   • Step 4: Add Device IDs
3. Usage
4. Support
5. Contributing
6. License
7. Acknowledgments

Requirements

• Home Assistant instance running
• Accessible Traccar Server

Installation

Follow these steps to install and configure the integration:

Step 1: Configure Traccar Device

1. Log in to your Traccar server.
2. Create a new device for each device_tracker you wish to monitor.
3. Ensure the device ID in Traccar matches the device_tracker ID in Home Assistant, as in picture.

Step 2: Import Package YAML File

1. Download the traccar_positioning.yaml file from this repository.

2. Place the file into the packages folder of your Home Assistant configuration.

   If the packages folder does not exist, you will need to create it following the official documentation.

Step 3: Configure Traccar Server IP

1. Open the traccar_positioning.yaml file with a text editor.
2. Replace the traccar_server_ip and traccar_server_port value with the IP address and Port (default for the used protocol is 5055) of your Traccar server instance.

Step 4: Add Device IDs

1. In the traccar_positioning.yaml file, add the IDs of the devices you want to track under the device_tracker.<device_tracker_1> keys.
2. Ensure the IDs match exactly those configured in Traccar.

Usage

After completing the installation and configuration, your Home Assistant device_tracker entities will be synchronized with Traccar, allowing you to monitor their real-time location.

Support

If you encounter any issues or have questions regarding the integration, please open an issue on this GitHub repository, and I will be happy to assist you. You can write to me at [email protected]

Contributing

Contributions to the project are welcome! Please fork the repository, make your changes, and submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE.md file for details. GNU AGPLv3 © [Lorenzo De Luca][https://lorenzodeluca.dev]

Acknowledgments

• Thanks to the Home Assistant community for providing a robust platform for home automation.
• Gratitude to the Traccar team for their excellent GPS tracking system.