Environment Variables
Except for container / keyword specific settings and regex patterns a lot of the settings can be configured via Environment Variables.
General Settings
| Variables | Description | Default |
|---|---|---|
LOG_LEVEL | Log Level for LoggiFly container logs. | INFO |
MULTI_LINE_ENTRIES | When enabled the program tries to catch log entries that span multiple lines. If you encounter bugs or you simply don't need it you can disable it. | True |
RELOAD_CONFIG | When the config file is changed the program reloads the config | True |
DISABLE_NOTIFICATIONS | Disable notifications when keywords are found. Useful when you only want to trigger actions. | False |
DISABLE_START_MESSAGE | Disable startup message. | False |
DISABLE_SHUTDOWN_MESSAGE | Disable shutdown message. | False |
DISABLE_CONFIG_RELOAD_MESSAGE | Disable message when the config file is reloaded. | False |
DISABLE_MONITOR_EVENT_MESSAGE | Disable message when the monitoring of a container stops or starts. | False |
COMPACT_SUMMARY_MESSAGE | Formats the summary message in startup and config reload notifications with a comma-separated list of containers instead of a multi-line list | False |
Notifications
| Variables | Description | Default |
|---|---|---|
NTFY_URL | URL of your ntfy server instance | N/A |
NTFY_TOKEN | Authentication token for ntfy in case you need authentication. | N/A |
NTFY_USERNAME | ntfy Username to use with the password in case you need authentication. | N/A |
NTFY_PASSWORD | ntfy password to use with the username in case you need authentication. | N/A |
NTFY_TOPIC | Notification topic for ntfy. | N/A |
NTFY_TAGS | Tags/Emojis for ntfy notifications. | kite,mag |
NTFY_PRIORITY | Notification priority for ntfy messages. | 3 / default |
NTFY_ICON | Icon URL to display with the notification (defaults to LoggiFly logo) | N/A |
NTFY_CLICK | URL to open when the notification is clicked | N/A |
NTFY_MARKDOWN | Enable markdown formatting in message (true/false), defaults to false | False |
APPRISE_URL | Any Apprise-compatible URL | N/A |
WEBHOOK_URL | URL of your custom webhook. | N/A |
Monitoring
| Variables | Description | Default |
|---|---|---|
LOGGIFLY_MODE | Set this variable to swarm when wanting to use LoggiFly in swarm mode | N/A |
CONTAINERS | A comma separated list of containers. These are added to the containers from the config.yaml (if you are using one). | N/A |
SWARM_SERVICES | A comma separated list of docker swarm services to monitor. | N/A |
GLOBAL_KEYWORDS | Keywords that will be monitored for all containers. Overrides global_keywords.keywords from the config.yaml. | N/A |
GLOBAL_KEYWORDS_WITH_ATTACHMENT | Notifications triggered by these global keywords have a logfile attached. | N/A |
MONITOR_ALL_CONTAINERS | Monitor all containers. | False |
MONITOR_ALL_SWARM_SERVICES | Monitor all swarm services. | False |
EXCLUDED_CONTAINERS | A comma separated list of containers that should not be monitored. To be used with MONITOR_ALL_CONTAINERS | N/A |
EXCLUDED_SWARM_SERVICES | A comma separated list of swarm services that should not be monitored. To be used with MONITOR_ALL_SWARM_SERVICES | N/A |
Other Settings
| Variables | Description | Default |
|---|---|---|
EXCLUDED_KEYWORDS | Keywords that will always be ignored. Can be used to suppress notifications from irrelevant log lines | N/A |
ATTACH_LOGFILE | Attach a Logfile to all notifications. | True |
ATTACHMENT_LINES | Define the number of Log Lines in the attachment file | 20 |
NOTIFICATION_COOLDOWN | Cooldown period (in seconds) per container per keyword before a new message can be sent | 5 |
ACTION_COOLDOWN | Cooldown period (in seconds) before the next container action can be performed. Always at least 10s. (action_keywords are only configurable in YAML) | 300 |
TITLE_TEMPLATE | Template for the notification title (see customize-notifications) | N/A |
MESSAGE_TEMPLATE | Template for the notification message (see customize-notifications) | N/A |
HIDE_REGEX_IN_TITLE | Exclude regex from the found keywords in the notification title for a cleaner look. Useful when using very long regexes. | False |
REGEX_CASE_SENSITIVE | Case sensitive regex matching. | False |
OLIVETIN_URL | URL of your OliveTin instance. | N/A |
OLIVETIN_USERNAME | Username for your OliveTin instance. | N/A |
OLIVETIN_PASSWORD | Password for your OliveTin instance. | N/A |