GTFS Realtime Test Setup Guide

Note: This is a test setup for sending vehicle positions to the GTFS realtime pipeline.

1. Access the Admin Panel

  1. Open: https://manage.rt.gtfs.zone/
  2. Click through the interface as needed.
  3. Choose Login with GitHub.

2. Create Required Resources

Create a Feed

  1. In the admin UI, create a new Feed.

Create a Driver

  1. Create a new Driver.
  2. Save the username and password — you will need them later.

3. Install OwnTracks

Install OwnTracks on your phone:

After installing:

  1. Open the app.
  2. Go to Preferences → Connection.

4. Configure MQTT Connection

Set the following values exactly:

SettingValue
ModeMQTT
Hostmqtt.gtfs.zone
Port443
Client IDanything
Use WebSocketsNo
Device IDGTFS Trip ID
Tracker IDanything
Username(driver username from UI)
Password(driver password from UI)
TLSYes
Client certificateNot set
Keepalive180
Clean SessionLeave default

5. Finish

  1. Save the configuration.
  2. Ensure OwnTracks has location permission.
  3. Start tracking.

6. Download the Feed

Vehicle positions will be available at:

https://rt.gtfs.zone/feed_name/vehicle_positions.pb

7. Helpful Resources

You can:

uv run scripts/fetch_vehicles.py feed_name --backend https://rt.gtfs.zone