mirror of https://github.com/ChuckBuilds/LEDMatrix.git synced 2026-05-16 18:23:32 +00:00

Files

Chuck d941c91f24 fix(systemd): wait for network connectivity before starting services (#335 )

Change After=network.target → After=network-online.target + Wants=network-
online.target in both service templates and install_web_service.sh.

network.target only guarantees NetworkManager has started — it does NOT
mean the device has an active internet connection. On boot the LED matrix
service was starting within seconds of the network interface appearing,
before WiFi association and DHCP completed, causing every first-update API
call to fail with "Network is unreachable" or DNS resolution errors.

network-online.target waits for a confirmed route before the service fires.
On Raspberry Pi OS this is provided by NetworkManager-wait-online. The
tradeoff is a few extra seconds at boot, acceptable for a display device.

Observed on devpi: service started at 14:48:03, all API calls (weather,
FlightRadar24, local ADS-B) failed at 14:48:07 with network errors, then
the service restarted cleanly at 14:50:40 once WiFi was established.

Co-authored-by: Chuck <chuck@example.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-15 15:47:35 -04:00

configure_web_sudo.sh

fix: service control buttons and AP-mode SSH lockout post-install (#326 )

2026-05-12 17:58:51 -04:00

configure_wifi_permissions.sh

fix: overhaul WiFi captive portal for reliable setup (#296 )

2026-03-27 14:50:33 -04:00

debug_install.sh

Feature/one shot installer (#178 )

2026-01-11 16:38:55 -05:00

install_service.sh

Plugins (#145 )

2025-12-27 14:15:49 -05:00

install_web_service.sh

fix(systemd): wait for network connectivity before starting services (#335 )

2026-05-15 15:47:35 -04:00

install_wifi_monitor.sh

Feature/one shot installer (#178 )

2026-01-11 16:38:55 -05:00

migrate_config.sh

Plugins (#145 )

2025-12-27 14:15:49 -05:00

one-shot-install.sh

Fix/duplicate display settings (#173 )

2026-01-14 10:51:55 -05:00

README.md

docs: refresh and correct stale documentation across repo (#306 )

2026-04-07 21:04:25 -04:00

setup_cache.sh

Plugins (#145 )

2025-12-27 14:15:49 -05:00

README.md

Installation Scripts

This directory contains scripts for installing and configuring the LEDMatrix system.

Scripts

one-shot-install.sh - Single-command installer; clones the repo, checks prerequisites, then runs first_time_install.sh. Invoked via curl ... | bash from the project root README.
install_service.sh - Installs the main LED Matrix display service (systemd)
install_web_service.sh - Installs the web interface service (systemd)
install_wifi_monitor.sh - Installs the WiFi monitor daemon service
setup_cache.sh - Sets up persistent cache directory with proper permissions
configure_web_sudo.sh - Configures passwordless sudo access for web interface actions
configure_wifi_permissions.sh - Grants the ledmatrix user the WiFi management permissions needed by the web interface and the WiFi monitor service
migrate_config.sh - Migrates configuration files to new formats (if needed)
debug_install.sh - Diagnostic helper used when an install fails; collects environment info and recent logs

Usage

These scripts are typically called by first_time_install.sh in the project root (which itself is invoked by one-shot-install.sh), but can also be run individually if needed.

Note: Most installation scripts require sudo privileges to install systemd services and configure system settings.