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

Files

Chuck c53e4995c4 fix(systemd): wait for network connectivity before starting services

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

network.target only means 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 all first-update API calls to fail
with "Network is unreachable" or DNS resolution errors.

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

Applied live to /etc/systemd/system/ledmatrix.service on devpi via
systemctl daemon-reload (no restart required for the config change to take
effect on next boot).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-15 15:14:50 -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

2026-05-15 15:14:50 -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.