LogAnalyzer¶

LogAnalyzer is a PHP web application for browsing syslog and related log data from files or databases. It comes from the same ecosystem as rsyslog.

Main log view	Login	Admin

Reports	Statistics

Documentation¶

Handbook (Docker install, Docker development & CI, LogAnalyzer user guide, third-party components): rsyslog.github.io/loganalyzer
docker/README.md — install walkthrough (docker compose from repo root, .env), file map (Dockerfile, compose files, scripts), handbook links
AGENTS.md — contributor notes: developer Docker stack (docker-compose.dev.yml), environment variables, PHPUnit, Playwright E2E
User guide chapters (imported into the handbook) are maintained as HTML under doc/

Quick start (Docker — default stack)¶

Step-by-step install: docker/README.md · handbook: Docker overview, Docker install.

docker/docker-compose.yml ships a fresh install by default: the database bootstrap creates schema, default views, and the admin user — no auto-added sample log sources. Fixture files remain available under /samplelogs in the image if you set LOGANALYZER_SEED_SAMPLE_SOURCES=1. MySQL data and config.php persist in named Compose volumes.

From the repository root, optionally copy docker/env.example → .env to customise LOGANALYZER_ADMIN_*, MYSQL_*, LOGANALYZER_DISK_*, and demo seeding — or use the handbook section Docker helper scripts (init-env-interactive, rebuild-consumer, etc.).

docker compose --project-directory . -f docker/docker-compose.yml up --build

Open http://localhost:8080/.

Credentials / DB defaults: see doc-site/docs/docker-install.md. Dev-only stack with a bind-mounted repo src/: doc-site/docs/docker-develop.md and docker/docker-compose.dev.yml.

Clean reset everything (drops MySQL and generated config volumes): sh docker/rebuild-consumer.sh or docker\rebuild-consumer.bat.

Tests and CI¶

Area	Where
PHPUnit	`composer install` then `composer test`
Playwright E2E	`e2e/README.md`, `docker/docker-compose.e2e.yml`
Workflows	`.github/workflows/` (PHP CI, Docker publish on tag `v*`, Playwright E2E, GitHub Pages)

On GitHub, the Playwright workflow can open an issue when E2E fails (same repository only); see AGENTS.md and e2e.yml.

Maintainer backlog¶

Informal TODOs and dated change bullets that previously lived here are archived in CHANGELOG.md.