Logs Viewer for Unraid

Real-time system, Docker and VM log viewer with dashboard widget and dedicated Tools page. Log backups and system alerts. Live auto-refresh, severity badges, search, filtering, syntax highlighting and export.

Features

• Dashboard Widget with live auto-refresh and severity proportion strip
• Tools Page for full-screen, focused log viewing
• System Logs: Syslog, Syslog Previous, Dmesg, GraphQL API, Nginx Errors, PHP Log, Libvirt
• Docker Logs with real-time running/stopped status indicators
• VM Logs with real-time running/stopped status indicators
• Log Backups: scheduled daily snapshots of all enabled sources, compressed and stored on a path you choose, with retention control and calendar-based download
• Alerts: pattern-based rules that scan logs every 1/2/5 minutes and push notifications through Unraid's notification system when a match is found. Includes one-click presets for failed logins, disk errors, OOM, kernel panics, array errors and Docker crashes
• Search: match highlighting with next/prev navigation
• Filtering: by severity level (Info, Warnings, Errors, Critical) or login events
• Severity Badges: clickable counters that double as quick filters
• Proportion Strip: color bar in the footer showing the error/warning/info ratio at a glance
• Syntax Highlighting: Highlight.js and Prism.js bundled locally, no CDN calls
• Autoscroll: follows new entries as they arrive, with pause-on-hover option
• Export: .log, .txt or structured .json with parsed timestamps and levels
• Responsive: works from wide monitors down to phones (five breakpoints)
• Theme Support: Black, Gray, Azure and White
• Independent Settings: Dashboard widget and Tool page configured separately
• Performance Friendly: single-source polling, content hash detection, pre-compiled regex, smart tail limits

Dashboard Widget PC Screen

Tool Page PC Screen

Installation

Community Applications (recommended)

1. Open Community Applications in Unraid
2. Search for Logs Viewer
3. Click Install

Manual

1. Go to Plugins in Unraid
2. Click Install Plugin
3. Paste the URL:

https://raw.githubusercontent.com/Lazaros-Chalkidis/unraid-logsviewer/main/logsviewer.plg

1. Click Install

Configuration

Go to Settings → Logs Viewer after installing. Four tabs: Dashboard, Tool, Backup and Alerts, each with their own settings.

Log Sources

System Logs

Syslog, Syslog Previous, Dmesg, Nginx Errors, GraphQL API, PHP Log, Libvirt. Selectable per page.

Docker Logs

Automatically discovers all containers. Each entry shows a green or red dot for running/stopped state. Select which ones to monitor.

VM Logs

Automatically discovers all VMs. Same status dots. Select which ones to monitor.

Log Backups

Daily compressed backups of all enabled log sources (system, Docker, VMs) to a storage path of your choice.

Settings include:

• Backup time (configurable hour)
• Storage path (defaults to /mnt/user/appdata/Logs-Viewer-Backup)
• Retention period (automatic cleanup of old backups)
• Calendar view in the Settings page showing available dates
• One-click ZIP download for any backup date

Backup directories are created with restricted permissions (700) so they are not exposed through Samba shares.

Alerts

The alert system scans log sources at regular intervals and sends notifications through Unraid's built-in notification system when a pattern match is found.

How it works:

• Define rules with a name, text or regex pattern, target sources and severity level
• Set a cooldown per rule to avoid repeated notifications for the same event
• The scanner runs as a cron job every 1, 2 or 5 minutes depending on your setting
• Matches are logged in the alert history (visible in the Settings page) and pushed as Unraid notifications

Built-in presets (one click):

• Failed Login (syslog)
• Disk Error (syslog, dmesg)
• Out of Memory (syslog, dmesg)
• Kernel Panic (syslog, dmesg)
• Array Error (syslog)
• Docker Crash (docker logs)

You can add your own rules on top of these.

Export Formats

Settings Page PC Screen

Security

• CSRF nonce on every API request (hourly rotation, stored in /tmp)¹
• Rate limiting: 60 requests/minute per IP
• Origin validation blocks cross-origin requests
• XSS sanitizer strips all span attributes except class, validates values against a character whitelist
• All htmlspecialchars calls use ENT_QUOTES
• INI writes strip control characters to block injection
• Whitelist validators on all settings fields (interval, theme, engine, format, font size, etc.)
• VM log paths checked with realpath to prevent directory traversal
• Content-hash parameter validated against a strict hex regex
• Alert patterns capped at 500 chars with lowered backtrack limit to prevent ReDoS
• Security headers on all API responses (X-Content-Type-Options, X-Frame-Options, CSP, Referrer-Policy)
• MD5 package integrity check on install

File permissions:

• Plugin directory: 755
• PHP / Page / Asset files: 644
• Config file and directory: 600 / 700
• Cache directory: 700
• Backup directory: 700
• No world-writable files

¹ Custom nonce instead of Unraid's built-in csrf_token. Deliberate choice to keep the API self-contained.

Development

Requirements

• Unraid 7.2.0 or later
• Bash (for the build script)

Build

./build.sh                  # release
./build.sh "" dev           # dev build
./build.sh "" "" local      # local build (embedded package, no internet)

Project Structure

unraid-logsviewer/
├── source/
│   ├── css/                        # widget.css, tool.css, settings.css
│   ├── js/                         # logsviewer.js (18 sections, TOC at top)
│   ├── include/                    # logsviewer_api.php, logsviewer-alerts-scan.php
│   ├── vendor/                     # hljs + prism (local bundles)
│   ├── Logsviewer.page             # Dashboard widget
│   ├── LogsviewerTool.page         # Tools page
│   ├── LogsviewerSettings.page     # Settings page
│   ├── logsviewer-alerts.sh        # Alert scanner cron wrapper
│   └── logsviewer-backup.sh        # Backup cron wrapper
├── screenshots/
├── build.sh
├── CHANGELOG.md
├── logsviewer.plg
└── logsviewer.xml

Changelog

See CHANGELOG.md

Issues & Support

Bug reports, feature requests or general feedback:

• GitHub Issues
• Unraid Forum Thread

Author

Lazaros Chalkidis — @Lazaros-Chalkidis

License

Copyright (C) 2026 Logs Viewer Unraid Plugin - Lazaros Chalkidis

Licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later). See the LICENSE file for the full text.