Live Trail is a self-hosted web application for sharing journeys on an interactive map. It combines live GPS positions from a SPOT tracker with GPX routes, posts, photos, videos, and a chronological activity feed, supporting both real-time tracking and historical travel stories.

Dependencies

nodejs 24+
composer
php-mbstring
php-imagick
php-gd
php-mysql
php-xml
php-exif
ffmpeg
STARTTLS Email Server (use Gmail if none available)
Optional: Geo Caching Server (WMTS Caching Service)

PHP Configuration

max_execution_time = 300
memory_limit = 500M
post_max_size = 4G
upload_max_filesize = 4G
max_file_uploads = 50

Getting started

Clone Git onto web server
Update php.ini parameters
Copy timezone data: mariadb-tzinfo-to-sql /usr/share/zoneinfo | mariadb -u root mysql
Copy settings-sample.php to settings.php and populate
Optional: if testing locally, copy one of the config/*.conf files to apache/nginx site folder
Follow CI/CD script in .gitea/workflows/deploy.yml
Add a GPX file named <project_codename>.gpx to /resources/geo/
Go to #admin and create a new project (with code name = <project_codename>) & feed

To Do List

Add mail frequency slider
Use WMTS servers directly when not using Geo Caching Server
Allow HEIF picture format
Garmin InReach Integration