Drup Trails
Toggle sidebar
Trackers and teams
These are the two core concepts in Drup Trails. A tracker is a device identity that sends location updates; a team is a group of people who can view and use those updates.
Tracker

A tracker represents one reporting device configuration. It has a short identifier (TID), an access token, and can publish location data to Drup Trails through the API endpoint.

  • Use one tracker per physical device or use-case for cleaner history.
  • The access token acts like a password for publishing reports.
  • You can update the tracker identifier later if needed.
Team

A team is a collaboration boundary. Members of that team can access data from trackers attached to the team based on team permissions.

  • Attach one tracker to multiple teams when sharing is intentional.
  • Detach trackers from teams to limit visibility without deleting the tracker.
  • Keep team membership current to reduce unnecessary exposure of location data.
How they work together
  1. Create a tracker for the device.
  2. Assign the tracker to one or more teams.
  3. Configure OwnTracks using the generated config link.
  4. Track reports arrive and become visible in the teams that tracker belongs to.