Install ChroGPS Dash Manually
If you prefer to set things up manually, ensure you have the following:
- Web Server: Nginx or Apache
- PHP: Version 8.2 or newer (with php-json extension enabled)
- System Utilities: sudo (required for executing chronyc commands)
- NTP/GPS: Chrony and GPSd installed and running
Configuration Details
Sudo Permissions
The dashboard requires permission to execute chronyc commands to fetch timing data. The installer adds the following line to /etc/sudoers:
www-data ALL=(ALL) NOPASSWD: /usr/bin/chronyc sources, /usr/bin/chronyc tracking, /usr/bin/chronyc serverstats, /usr/bin/chronyc -n clients
…So you will likely need to do the same.
Log File Access
- The charts are generated by parsing raw Chrony logs (tracking.log, statistics.log, measurements.log). The installer:
- Adds the
www-datauser to the_chronygroup. - Sets group-read/write permissions (
g+rw) on the log files in/var/log/chrony. - Configures Chrony to log the data if it’s not enabled.
…So you will need to perform these tasks if you wish to install ChroGPS Dash manually.
GPSD Integration
The dashboard connects to gpsd via a local socket on port 2947. Ensure gpsd is configured to listen on all interfaces or at least localhost.
Install The Script
Once you have everything setup, grab the script and place it in a location accessible from your web server.