Firecrawl Monitor

Internal, read-only Bull Queue dashboard for the Majlis HomeLab Firecrawl deployment.

What it does

• Provides an Arabic operational dashboard for API health, request totals, success rate, latency, NuQ workers, and queue state.
• Proxies Firecrawl's built-in Bull Board UI under /queues/ for advanced inspection.
• Keeps BULL_AUTH_KEY server-side and removes it from browser-visible paths.
• Allows only GET, HEAD, and OPTIONS requests, preventing queue mutations.
• Restricts access to the trusted HomeLab LAN 192.168.10.0/24 and server network 192.168.30.0/24; the untrusted wireless network remains denied.
• Exposes a container health endpoint at /healthz.

Deployment

cp .env.example .env
# Fill BULL_AUTH_KEY from the protected Firecrawl server environment.
docker compose up -d --build

The Compose project expects the existing external Docker network firecrawl_backend and upstream API service name api.

Default URL:

http://firec-monitor.majlis.lab

Verification

curl -fsS http://firec-monitor.majlis.lab/healthz
curl -fsS http://firec-monitor.majlis.lab/ | grep -F 'Firecrawl Monitor'

A write request must return HTTP 405:

curl -o /dev/null -w '%{http_code}\n' -X POST http://firec-monitor.majlis.lab/api/queues

Security model

This UI is internal and read-only. The raw Firecrawl API remains bound to server loopback. Do not commit .env or the Bull authentication key.