Skip to main content...

ChroGPS Dash

ChroGPS Dash is a lightweight, high-performance, and mobile-friendly web dashboard for monitoring GPS-disciplined Stratum 1 NTP servers on Debian (and equivalent) which run Chrony and GPSd. It provides real-time diagnostics and metrics for Chrony and GPSd, featuring a live satellite skyview, SNR telemetry, precision timing metrics, and more.

ChroGPS Dash is Free and Open Source Software released under the MIT License.

Quick Installation

Recommended

One-Line Install

On a Debian-based instance, run the following command to install ChroGPS Dash:

curl -fsSL https://chro.gpsda.sh/install | sudo bash

Then, simply point your browser to http://chrogps-dash.local to access the Dashboard.1

(Chrony and GPSd must already be installed and running before the installer. The installer handles Nginx, PHP-FPM, permissions, and dashboard deployment automatically.)

Important

When installation completes, the installer generates a unique admin token and prints it prominently in the terminal. Save it — you will need it to access the Admin Panel and authenticate one-click updates. If you miss it, retrieve it at any time without changing it:

curl -fsSL https://chro.gpsda.sh/install | sudo bash -s -- -dt

Screenshots

Dark Theme
Dashboard: Dark Theme
Light Theme
Dashboard: Light Theme
Client Connections Modal
Client Connections Modal
Admin Modal: Dashboard Settings
Admin Modal: Dashboard Settings
Admin Modal: Dashboard Features
Admin Modal: Dashboard Features
Admin Modal: Dashboard Security
Admin Modal: Dashboard Security
Admin Modal: System Functions
Admin Modal: System Functions
Legend / Glossary Modal
Legend / Help Modal
Note
Not all twenty-one themes are shown above.

Features

  • Mission Control Dashboard: A comprehensive, real-time view of Chrony sources, GPS satellite status, and an interactive skyview with per-constellation filtering.
  • Signal & Sync Health Monitoring: Intelligent, color-coded health scores for antenna signal integrity and clock synchronization precision.
  • Performance Tracking Sparklines: Instant visual SNR trends for every satellite, allowing you to monitor signal stability over the last 60 minutes at a glance.
  • Native SVG Analytics: Ten interactive, server-side generated history graphs for performance, stability, and GNSS metrics - built with zero external dependencies.
  • Advanced Solar Interference Tracking: Real-time solar position overlay to help distinguish solar interference events from hardware failures.
  • Sophisticated UI/UX: A fully responsive, mobile-friendly interface featuring 21 color themes, keyboard shortcuts, draggable layout reordering, collapsible dashboard sections, and persistent satellite table sorting.
  • Integrated Admin Panel: Browser-based configuration and system management (service restarts, log purging) without needing SSH.
  • Lightweight & Private: A zero-dependency, self-contained PHP/JS backend with no external fonts, trackers, or internet requirements. Includes an optional dashboard-wide authentication gate for public-facing instances.
  • Advanced Technical Design: Engineered with O(log n) binary search algorithms and a custom SVG graphing engine. See the Technical Specifications for more.
  • Universal GNSS Compatibility: If GPSd supports your receiver, ChroGPS Dash does too. See the GNSS Compatibility Guide for details.

Updating ChroGPS Dash

Recommended

Use the Built-In Update Button

When a new version is available, an Update Available button appears in the dashboard header. Click it, enter your admin token, and the update downloads, verifies, and installs automatically - with a live progress display. No SSH or command line needed.
Your admin token is always visible in the Admin Panel → Security tab, or by running a single command in your terminal:

curl -fsSL https://chro.gpsda.sh/install | sudo bash -s -- -dt

If you prefer the command line, simply re-run the Quick Installation command - it updates the dashboard in place and retains all of your custom settings.


Tip
ChroGPS Dash checks for updates once every 8 hours. If an update is found, an Update Available button appears in the dashboard header and persists across page reloads until the update is applied. Users can disable update checks in the Admin Panel.

Requirements

  • OS: Debian 12 (bookworm) or greater, or a supported distribution.
  • Hardware: Raspberry Pi or similar SBC with a GPS module connected.
  • Pre-installed: Chrony and GPSd must be installed and running before running the installer.
  • Installed by the installer: Nginx, PHP-FPM 8.2+.

Supported Distributions

In addition to native Debian 12 (bookworm) or greater, the installer explicitly supports:

  • Ubuntu: 22.04 LTS and greater.
  • Raspberry Pi OS: Versions based on Bookworm or greater.
  • Armbian: Versions tracking the Debian 12+ or Ubuntu 24.04+ repositories.
  • Linux Mint: 22 and newer (based on the Ubuntu 24.04+ package set).

Documentation

Page Description
GNSS Compatibility Supported GPS receivers and how compatibility works
Troubleshooting & Support Common issues and fixes
Manual Installation Install without the one-line installer
Advanced/Manual Configuration All optional settings, history graph logging, and installer command reference
Technical Specifications Architecture, internal logic, algorithms, and performance design
Architecture Internal code layout, request lifecycle, AJAX contract, data flows, and frontend structure
Development and Contributing Guide Development guidelines, UI style guide, and how to contribute code

Software License

ChroGPS Dash is distributed under the MIT License.

  1. The ChroGPS Dash installer configures ZeroConf/mDNS so that the dashboard can be easily accessed from your local network via “http://chrogps-dash.local”. If you do not want this functionality, run the installer command with the “-np” flag:

    curl -fsSL https://chro.gpsda.sh/install | sudo bash -s -- -np

    ChroGPS Dash will then be installed and configured without the ZeroConf/mDNS (avahi) daemon/configuration. ⤴

Authored on 2026-01-28

Last Revision: 2026-06-22 -- Document Version: 531449e
Permanent Link: <https://w0chp.radio/chrogps-dash/>