Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[Support] Boltarr - Self-hosted Network Dashboard]

Featured Replies

Boltarr is a self-hosted network dashboard for mapping, monitoring, and

analyzing your local network — all on your own hardware, no cloud.

GitHub: https://github.com/brq-ae/boltarr

Docker Hub: https://hub.docker.com/r/brqae/boltarr

Wiki/Docs: https://github.com/brq-ae/boltarr/wiki

WHAT IT DOES

- Discovery & scanning: nmap-powered host/port discovery with reusable scan

profiles 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 and

a daily digest.

- Uptime monitoring: host liveness (online/offline) plus per-service up/down

checks with alerts, grace periods, quiet hours, and uptime history — with

host<->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/private

gating, branding, announcements, a maintenance calendar, an incident

timeline, 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), any

OpenAI-compatible API, or Anthropic. Fully optional; Boltarr works without it.

INSTALL

- Unraid: Community Applications — search "boltarr" (or add the template URL

from the GitHub readme). The template uses Network Type: Host with

NET_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 the

readme/wiki.

Your data stays local (a small SQLite database + config file). Open source

under Apache-2.0.

Post here for support, bug reports, or feature requests.

Edited by BinAdhed

  • 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 page
v0.8.0 configurable scan engine + reusable scan profiles
v0.9.0 scan scheduler, change tracking & alerts, host liveness, timezone
v0.10.0 scan active windows, alert scoping, live probe progress
v0.11.0 host monitoring (uptime, correlation, status page)
v0.11.2 consolidated to a single docker-compose.yml
v0.11.3 factory reset, bulk delete, accordion settings
v0.12.0 inline editing in the Hosts table
v0.13.0 inline editing in the Services table
v0.14.0 reset uptime tracking
v0.15.0 90-day uptime history on the status page
v0.16.x incident timeline, configurable uptime windows, configurable probe interval + 1h tick, automated-maintenance windows, clear incidents
v0.17.0 AI assistant is now live-network-aware, with streaming
v0.17.x status page: timezone-consistent times, no calendar flicker, mobile incident fix
v0.18.0 service check types (HTTP/TCP/ICMP), monitor-target override, Edit Service pop-up
v0.18.1 ICMP check fix + detail panel / edit pop-up kept in sync
v0.18.2 concise daily digest: per-device grouping + flapping rollup
v0.19.0 IP History tab + Backup/Restore moved to Settings → Data
v0.20.0 hardening: optional login, password-protected backups, restore without restart, alias IP alerts, safety fixes, automated tests
v0.21.0 Content-Security-Policy + security headers, everything self-hosted, Settings → Security
v0.21.1 Topology Graph | Hierarchy, Scan Log rename, login help
v0.21.2 status page: per-card outage history, font + favicon choice, LAN-only push
v0.22.4 global search, CSV / JSON export, silent schedules, formatted AI chat, narrow-screen columns

Docs & full guide: https://github.com/brq-ae/boltarr/wiki

Full release notes: https://github.com/brq-ae/boltarr/releases

As always, post here for support, bug reports, or feature requests.

Edited by BinAdhed
adding to changelog

  • 1 month later...

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.

  • 4 weeks later...
  • 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.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.