Repository navigation
Configuration file
github-actions[bot] edited this page Oct 10, 2026
·
1 revision
Instead of long command lines, put options in a JSON file and pass --config frontail.json.
{
"port": 9001,
"theme": "dark",
"ui-highlight": true,
"user": "admin",
"passwordFile": "/run/secrets/frontail_password",
"journal-unit": ["sshd", "nginx"],
"ssh": ["deploy@web1:/var/log/syslog"],
"files": ["/var/log/syslog", "/var/log/nginx/error.log"]
}- Keys are option names in camelCase or kebab-case (
uiHideTopbarorui-hide-topbar). -
fileslists the files to tail (used when none are given on the command line). - Command-line flags win over the file.
- Unknown keys are rejected with a clear error, so typos don't silently do nothing.
- Repeatable options (
container,journal-unit,ssh,allowed-origin) take arrays. - Keep secrets out of the file: use
passwordFileor theFRONTAIL_PASSWORDenvironment variable.
frontail is MIT licensed. Fork of mthenw/frontail · Sponsor @hbenali · Docs live in docs/wiki.