# Systemd Service Files

This directory contains systemd service unit files for LEDMatrix services.

## Service Files

- **`ledmatrix.service`** - Main LED Matrix display service
  - Runs the display controller (`run.py`)
  - Starts automatically on boot
  - Runs as root for hardware access

- **`ledmatrix-web.service`** - Web interface service
  - Runs the web interface conditionally based on config
  - Starts automatically on boot if `web_display_autostart` is enabled
  - Uses `scripts/utils/start_web_conditionally.py`

- **`ledmatrix-wifi-monitor.service`** - WiFi monitor daemon service
  - Monitors WiFi/Ethernet connectivity
  - Automatically enables/disables access point mode
  - Uses `scripts/utils/wifi_monitor_daemon.py`

## Installation

These service files are installed by the installation scripts in `scripts/install/`:
- `install_service.sh` installs `ledmatrix.service`
- `install_web_service.sh` installs `ledmatrix-web.service`
- `install_wifi_monitor.sh` installs `ledmatrix-wifi-monitor.service`

## Manual Installation

> **Important:** the unit files in this directory contain
> `__PROJECT_ROOT_DIR__` placeholders that the install scripts replace
> with the actual project directory at install time. Do **not** copy
> them directly to `/etc/systemd/system/` — the service will fail to
> start with `WorkingDirectory=__PROJECT_ROOT_DIR__` errors.
>
> Always install via the helper script:
>
> ```bash
> sudo ./scripts/install/install_service.sh
> ```
>
> If you really need to do it by hand, substitute the placeholder
> first:
>
> ```bash
> PROJECT_ROOT="$(pwd)"
> sed "s|__PROJECT_ROOT_DIR__|$PROJECT_ROOT|g" systemd/ledmatrix.service \
>   | sudo tee /etc/systemd/system/ledmatrix.service > /dev/null
> sudo systemctl daemon-reload
> sudo systemctl enable ledmatrix.service
> sudo systemctl start ledmatrix.service
> ```

## Service Management

```bash
# Check status
sudo systemctl status ledmatrix.service

# Start/stop/restart
sudo systemctl start ledmatrix.service
sudo systemctl stop ledmatrix.service
sudo systemctl restart ledmatrix.service

# Enable/disable autostart
sudo systemctl enable ledmatrix.service
sudo systemctl disable ledmatrix.service

# View logs
journalctl -u ledmatrix.service -f
```