Skip to content

Routario Platform

Routario is a high-performance, self-hosted GPS tracking and fleet management platform. It provides real-time live maps, smart alerts, cloud integrations, and a full PWA you can install on any device — all running on infrastructure you control.

See It in Action

What can it do?

  • 8 Native Protocols

    Built-in TCP/UDP decoders for Teltonika, GT06, TK103, Queclink, Meitrack, H02, Flespi, and OsmAnd.

    Supported Devices

  • Smart Alerts

    Speed limit alerts backed by real road data (Valhalla/OSM), geofence events, ignition, SOS, custom sensor rules and more.

    Alerts

  • Cloud Integrations

    Pull live positions from Wialon, Flespi Cloud, Traccar, 3D Tracking, GPS-Server.net, and Google Find Hub alongside your native devices. A built-in GPS Simulator lets you test without real hardware.

    Cloud Integrations

  • Rich Notifications

    Telegram, Email, Slack, Discord, SIP voice calls, webhooks, browser push — via the Apprise library or Web Push API.

    Notifications

  • Backend-Defined Reports

    Fleet summaries, trips, daily activity, driver activity, user fleet, sensors, alerts, scheduled delivery, and CSV exports.

    Reports

  • PWA Support

    Install Routario on iOS and Android from the browser. Offline-capable with native-style push notifications.

    Features

  • Trip History

    Playback routes, explore sensor graphs, view trip summaries, and export raw position data as CSV.

    Features

How It Works

Routario runs as a single Python/FastAPI application managing three concurrent responsibilities:

  1. Protocol Gateway — listens on TCP/UDP ports for the native protocols used by active devices, decodes incoming packets into a normalised position format, and persists them to the database.
  2. REST API + WebSocket — serves the web frontend, exposes a JSON API for all CRUD operations, and broadcasts live position updates in real time.
  3. Alert & Integration Engine — runs background tasks that evaluate alert rules per device, poll cloud integrations, and dispatch notifications.

Stack

Python 3.10+ · FastAPI · SQLAlchemy 2 (async) · SQLite (default) or PostgreSQL · Redis (optional) · Valhalla (optional, for road speed limits)

Quick Start

Get up and running in three commands — no Docker or database setup required:

git clone https://github.com/bkbilly/routario.git
cd routario
pip install -r requirements.txt
python app/main.py

Routario starts with SQLite by default. The database file routario.db is created automatically on first run. Open http://localhost:8000 and log in with admin / admin_password.

Production deployments

For a production setup — PostgreSQL, Redis pub/sub, multiple workers, reverse proxy — see the full installation guide.

Full Installation Guide