Registry / analytics / haraka-plugin-graph

haraka-plugin-graph

library1.0.6jsnpmunverified

A Haraka SMTP server plugin that logs accepted and rejected email metrics into a SQLite database and serves a web UI for visualizing plugin rejection graphs over time. Current stable version is 1.0.6, released with low cadence. Key differentiator: built specifically for Haraka, lightweight, no external dependencies beyond optional sqlite3. For use only as a Haraka plugin, not standalone.

analytics

npm install haraka-plugin-graph

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · HARAKA-PLUGIN-GRAP

haraka-plugin-graph

analyticsjavascriptv1.0.6

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

haraka-plugin-graph

✓ config/plugins: graph

✗ not required via JavaScript

Loaded as a Haraka plugin via config/plugins file, not via import or require in user code.

Install, enable, and configure the Haraka Graph plugin with SQLite backend.

# Install the plugin npm install haraka-plugin-graph npm install sqlite3 # Add to Haraka config/plugins file echo 'graph' >> config/plugins # Configure (optional, defaults shown) mkdir -p config echo 'db_file=:memory: http_addr=127.0.0.1 http_port=8080 ignore_re=queue|graph|relay' > config/graph.ini # Restart Haraka haraka -c .

Debug

Known issues

gotchaThe sqlite3 module must be installed separately in the Haraka directory.

fix

Run 'npm install sqlite3' in the same directory as Haraka.

affects: >=1.0.0

gotchaPlugin can only be used within Haraka SMTP server, not as a standalone library.

fix

Install Haraka and add 'graph' to config/plugins.

affects: >=1.0.0

gotchaDefault http_addr is 127.0.0.1, making the web UI inaccessible from other machines without configuration change.

fix

Set http_addr=0.0.0.0 to listen on all interfaces (security risk).

affects: >=1.0.0

gotchaRegular expression ignore_re specified as pipe-delimited list; no spaces. Malformed regex can crash plugin.

fix

Ensure ignore_re value is a valid Regex pattern without unknown escape sequences.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'sqlite3'

sqlite3 package not installed in Haraka directory.

fix

Run 'npm install sqlite3' in the Haraka root directory.

Error: listen EADDRINUSE :::8080

Port 8080 already in use by another service.

fix

Change http_port in config/graph.ini to a different value.

Error: Invalid regular expression: /queue|graph|relay/

Typo in ignore_re config (e.g., missing closing slash).

fix

Correct the regex syntax in config/graph.ini, e.g., queue|graph|relay

Upgrade

Version history

1.0.6latest on npm

Audit

Dependencies

sqlite3optionalRequired for database operations. Must be installed separately in Haraka directory.

Agent activity

35 hits · last 30 days

node

OpenAI (training)

Resources

githubgit://github.com/haraka/haraka-plugin-graph ↗

packageharaka-plugin-graph ↗

homepagehttps://github.com/haraka/haraka-plugin-graph ↗