May 11May 11 Boltarr is a self-hosted network dashboard for mapping, monitoring, andanalyzing your local network — all on your own hardware, no cloud.GitHub: https://github.com/brq-ae/boltarrDocker Hub: https://hub.docker.com/r/brqae/boltarrWiki/Docs: https://github.com/brq-ae/boltarr/wikiWHAT IT DOES- Discovery & scanning: nmap-powered host/port discovery with reusable scanprofiles and a scheduler (interval or weekdays, with active-hours windows).- Change tracking & alerts: records what changed between scans (new hosts,opened/closed ports, MAC/hostname changes) with ntfy push notifications anda daily digest.- Uptime monitoring: host liveness (online/offline) plus per-service up/downchecks with alerts, grace periods, quiet hours, and uptime history — withhost<->service correlation so one down box doesn't flood you with alerts.- Topology: interactive graph with VLAN coloring and connection types(wired/wifi/fiber/DAC/virtual).- Device & service management: add/edit inline, merge multi-homed devices,DHCP-aware static/dynamic classification, notes, and SSH key management.- Public status page: push a sanitized status summary (public names + up/down,never internal IPs) to a separate, internet-facing page — with public/privategating, branding, announcements, a maintenance calendar, an incidenttimeline, and automated-maintenance windows.- AI assistant (optional): live-network-aware and streaming — ask what's down,what changed, or what's been flapping. Works with Ollama (local), anyOpenAI-compatible API, or Anthropic. Fully optional; Boltarr works without it.INSTALL- Unraid: Community Applications — search "boltarr" (or add the template URLfrom the GitHub readme). The template uses Network Type: Host withNET_RAW/NET_ADMIN caps so nmap can scan your LAN — leave that as-is.- Docker: a single docker-compose.yml (host networking by default). See thereadme/wiki.Your data stays local (a small SQLite database + config file). Open sourceunder Apache-2.0.Post here for support, bug reports, or feature requests. Edited August 6Aug 6 by BinAdhed
May 14May 14 Author CHANGELOG & UPDATES (v0.7.0 – v0.22.4)It's been a big few months since the v0.6.2 port change. Here's everything that's new, grouped by area, with a full version list at the bottom.── WHAT'S NEW SINCE v0.20 ───────────────────────────- Global search (v0.22.4): a search box in the top bar finds hosts and services as you type — IP, alias IPs, hostname, MAC (with or without separators), vendor, OS, notes, open ports, service name, port or URL. Press / or Ctrl+K from anywhere. On phones it's a 🔍 button.- Export to CSV / JSON (v0.22.4): Hosts, Services and IP History have an Export menu. It exports the rows you're looking at (search, filters and sort applied) with every column, and the CSV opens cleanly in Excel / Google Sheets.- Silent schedules (v0.22.4): mark a scan schedule as silent and it still records changes, but sends no ntfy alert. Its changes still show in the Changes tab and the daily digest.- Optional login (v0.20.0): turn on a username/password for the dashboard. Locked out? Run the reset-password command inside the container.- Browser security (v0.21.0): Content-Security-Policy and security headers on every page, and the graph library and fonts are now bundled — nothing loads from the internet. Settings → Security lets you choose which dashboards (Homarr, Heimdall, etc.) may embed Boltarr.- Better on phones and narrow screens (v0.22.4): columns hide in order of importance when space runs out and come back when there's room. Pin a column (📌) to always keep it — the table scrolls sideways instead.── MONITORING & UPTIME ──────────────────────────────- Service uptime monitor: per-service up/down checks (HTTP, TCP or ICMP ping) with ntfy alerts, a grace period, quiet hours, and uptime history. The check target can differ from the host the service runs on.- Host liveness: a light ping sweep marks every host online/offline, tracks per-host uptime, and correlates service outages to a down host (so one offline server doesn't fire a flood of service alerts). Alias IPs are now pinged and alerted too.- Configurable probe interval (15–600s) and a per-service "reset uptime".── SCANNING & IP MANAGEMENT ─────────────────────────- Configurable scan engine + reusable scan profiles (Quick/Standard/Full + custom).- Scan scheduler with active-hours windows, plus live probe progress. Schedules can be set to silent (no alerts, changes still recorded).- Change tracking & alerts: records what each scan finds different (new hosts, opened/closed ports, MAC/hostname changes) with per-scan summaries and a daily digest (de-duplicated per device, with flapping rolled up); alert scoping by static/dynamic and per-host opt-outs.- IP History: every static-range IP in a subnet shown as In use / Recent / Stale / Gone / Never seen, with the last hostname/MAC/vendor seen on it — so you know which static IPs are safe to reuse. Thresholds configurable (default 30 / 60 days).- Timezone-aware scheduling, quiet hours, and digests.── SECURITY & BACKUPS ───────────────────────────────- Optional dashboard login, with a reset-password command for lockouts.- Content-Security-Policy and security headers; everything self-hosted, nothing loaded from outside.- Optional password-protected backups, and restore in place without a restart.- Network text (hostnames, banners, notes) is escaped everywhere, Settings save all-or-nothing, and partial edits no longer wipe other fields.- Automated tests now run before every image is built.── PUBLIC STATUS PAGE (separate app) ────────────────- Push a sanitized status summary to a separate, internet-facing page — public names and up/down only, never internal IPs. Ships as a prebuilt image.- Public/private section gating with a hardened admin login, announcements, and a recurring maintenance calendar.- Full branding (name, logo, colors, font: System / Inter / Cairo, separate favicon), configurable uptime windows (1h / 24h / 7d / 30d), and a per-minute "1 hour" tick bar.- Incident timeline (down -> back -> duration), and automated-maintenance windows that relabel expected dips (e.g. nightly backups) as amber "Scheduled maintenance" instead of red — the downtime still counts, only the cause is labelled. Plus a "clear past incidents" control.- Click any card to see that service's own recent outages.- Times always show in the page's configured timezone (with the local time shown next to the zone, so a wrong setting is obvious); calendar no longer flickers on updates; incidents display properly on mobile.- The page now refuses status pushes that arrive through a reverse proxy, even with the token — Boltarr should push to its LAN address.── AI ASSISTANT ─────────────────────────────────────- The assistant is live-network-aware: it knows what's down right now, recent changes, and outage/flapping patterns — and it streams responses.- Replies are now properly formatted (headings, lists, tables, code blocks with a Copy button). New Stop button (or Esc), a wide chat mode, and Copy all / Download the conversation as Markdown.- Still optional and provider-agnostic: Ollama (local), any OpenAI-compatible API, or Anthropic.── UI / QUALITY OF LIFE ─────────────────────────────- Global search (/ or Ctrl+K) and CSV / JSON export.- Inline editing + column controls in the Hosts and Services tables; columns auto-hide on narrow screens, with 📌 pins to keep the ones you need.- Full Edit Service pop-up, in sync with the detail panel; unused fields grey out per check type.- Topology now holds Graph | Hierarchy; Scans → History renamed Scan Log; toolbars stay in place while you scroll long lists.- Topology zoom/ESC improvements; fixed-height, drag-resizable detail panels.- Factory reset, bulk delete, and an accordion settings panel (Backup & Restore live in Settings → Data).- Editable host IP; restore migrates backups from older versions.── UPGRADE NOTES ────────────────────────────────────- After updating to v0.22.4, refresh Boltarr once with Ctrl+Shift+R (Cmd+Shift+R on Mac) so your browser picks up the new pages. From then on a normal reload is enough.- Deployment is a single docker-compose.yml, and host networking is the default so nmap can actually scan your LAN. On Unraid the template already sets Network Type: Host with NET_RAW/NET_ADMIN caps — leave that as-is.- The public status page runs as its own container (default port 12102) on a SEPARATE host from Boltarr — keep Boltarr off any internet-facing box.- If you use the status page, set Boltarr's status-page URL to the page's LAN address, not the public/proxied one — pushes through a proxy are now refused.- Login is off by default; turn it on in Settings if you want it.── FULL VERSION LIST ────────────────────────────────v0.7.0 service uptime monitor + public status pagev0.8.0 configurable scan engine + reusable scan profilesv0.9.0 scan scheduler, change tracking & alerts, host liveness, timezonev0.10.0 scan active windows, alert scoping, live probe progressv0.11.0 host monitoring (uptime, correlation, status page)v0.11.2 consolidated to a single docker-compose.ymlv0.11.3 factory reset, bulk delete, accordion settingsv0.12.0 inline editing in the Hosts tablev0.13.0 inline editing in the Services tablev0.14.0 reset uptime trackingv0.15.0 90-day uptime history on the status pagev0.16.x incident timeline, configurable uptime windows, configurable probe interval + 1h tick, automated-maintenance windows, clear incidentsv0.17.0 AI assistant is now live-network-aware, with streamingv0.17.x status page: timezone-consistent times, no calendar flicker, mobile incident fixv0.18.0 service check types (HTTP/TCP/ICMP), monitor-target override, Edit Service pop-upv0.18.1 ICMP check fix + detail panel / edit pop-up kept in syncv0.18.2 concise daily digest: per-device grouping + flapping rollupv0.19.0 IP History tab + Backup/Restore moved to Settings → Datav0.20.0 hardening: optional login, password-protected backups, restore without restart, alias IP alerts, safety fixes, automated testsv0.21.0 Content-Security-Policy + security headers, everything self-hosted, Settings → Securityv0.21.1 Topology Graph | Hierarchy, Scan Log rename, login helpv0.21.2 status page: per-card outage history, font + favicon choice, LAN-only pushv0.22.4 global search, CSV / JSON export, silent schedules, formatted AI chat, narrow-screen columnsDocs & full guide: https://github.com/brq-ae/boltarr/wikiFull release notes: https://github.com/brq-ae/boltarr/releasesAs always, post here for support, bug reports, or feature requests. Edited November 10Nov 10 by BinAdhed adding to changelog
June 20Jun 20 Is there a quick setup guide that tells step by step what to do and how to get the best use out of it? I set up a subnet and told AI to run an analysis of it (ongoing) but am not really sure I'm getting full use out of it.
July 17Jul 17 Author On 6/20/2026 at 7:31 AM, dclive said:Is there a quick setup guide that tells step by step what to do and how to get the best use out of it? I set up a subnet and told AI to run an analysis of it (ongoing) but am not really sure I'm getting full use out of it.I still did not get to the step by step guide, but it should be easy to get around, what you need to do is first have the app scan the network, it will use nmap built in, once that is done, you can have the Ai (that you connect) analyze your setup.the point of Ai is after filling up your network, hosts, services etc, the Ai can give you better insight.
Join the conversation
You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.