🗺️ Reitti — Location & Route Tracking
Host: Homelab · Compose: Homelab/Docker/reitti/compose.yaml
Stack name: reitti
1. Overview
Reitti is a self-hosted location history and route tracking application backed by PostGIS (spatial PostgreSQL), RabbitMQ for async processing, Redis for caching, and Photon for geocoding. Authentication is handled by Authentik via OIDC. Data can be imported from GPX files or phone apps.
2. Architecture & Services
| Service |
Image |
Port |
Role |
reitti |
dedicatedcode/reitti:4.0.5 |
25480 |
Main web application (route tracker) |
photon |
rtuszik/photon-docker:2.2.0 |
— |
Offline geocoding engine (Nominatim-based) |
postgis |
postgis/postgis:17-3.5-alpine |
— |
Spatial PostgreSQL database |
rabbitmq |
rabbitmq:4.3.1-management-alpine |
— |
Async message queue for import processing |
redis |
redis:7-alpine |
— |
Caching layer |
3. Networking
reitti — Internal bridge connecting all services.cloudflare-net — Routes public traffic to reitti.m1ckyb.com.
4. Persistent Storage
| Container |
Host Path |
Description |
photon |
/docker/data/services/reitti/photon |
Geocoding index data (Australia/Oceania region) |
postgis |
/docker/data/services/reitti/postgis |
Spatial database |
rabbitmq |
/docker/data/services/reitti/rabbitmq |
Message queue state |
redis |
/docker/data/services/reitti/redis |
Redis persistence |
5. Environment Variables
| Variable |
Service |
Description |
PHOTON_BASE_URL |
reitti |
http://photon:2322 |
OIDC_ENABLED |
reitti |
true |
OIDC_ISSUER_URI |
reitti |
https://authentik.m1ckyb.com/application/o/reitti/ |
OIDC_CLIENT_ID |
reitti |
Authentik application client ID |
OIDC_CLIENT_SECRET |
reitti |
Authentik application client secret |
POSTGRES_USER / POSTGRES_PASSWORD / POSTGRES_DB |
postgis |
reitti / reitti / reittidb |
RABBITMQ_DEFAULT_USER / RABBITMQ_DEFAULT_PASS |
rabbitmq |
reitti / reitti |
UPDATE_STRATEGY |
photon |
PARALLEL |
REGION |
photon |
australia-oceania |
6. Access & Usage
| URL |
Description |
https://reitti.m1ckyb.com |
Reitti web UI (OIDC login via Authentik) |
http://localhost:25480 |
Direct local access |
# Start (Photon will download the geocoding index on first run)
docker compose -f Homelab/Docker/reitti/compose.yaml up -d
# Monitor Photon download progress
docker logs reitti_photon_1 -f
7. Maintenance & Backup
# Update
docker compose -f Homelab/Docker/reitti/compose.yaml pull
docker compose -f Homelab/Docker/reitti/compose.yaml up -d
# Backup
rsync -av /docker/data/services/reitti/ /backup/reitti/
[!NOTE]
The Photon geocoding index for australia-oceania is several GB. Allow extra time on first start.