Demos

• Demo Video

Requirements

• Django >= 6.1.1

• Python >= 3.12

• Sessions enabled

Installation

• Install the package with pip install django-logtailer

• Add it to the INSTALLED_APPS in your SETTINGS

• Set LOGTAILER_ALLOWED_ROOTS in your SETTINGS (see Settings below)

• add to urls.py: url(r’^logs/’, include(‘logtailer.urls’)),

• Run manage.py migrate for create the required tables

• Run manage.py collectstatic

Settings

LOGTAILER_ALLOWED_ROOTS (mandatory): list of directories log files are allowed to live in. Paths are fully resolved (symlinks and .. included) before checking, preventing path traversal (CWE-22). If the setting is missing or empty, access to every log file is denied:

LOGTAILER_ALLOWED_ROOTS = ['/var/log/myapp']

Filters

Filters (saved in the admin or typed in the custom filter field) are Python regular expressions evaluated server-side with re.search() against each raw log line. Only matching lines are returned to the browser.

• Write plain patterns, not JavaScript literals: use networkmanager, not /networkmanager/.

• Flags are inline groups: case-insensitive matching is (?i)networkmanager, not /networkmanager/i.

• An invalid regex falls back to a literal substring match.

Running tests

From the repository root:

python runtests.py

The suite uses a minimal standalone settings module (tests/settings.py) with an in-memory SQLite database, so no extra setup is needed.