Home

Welcome to the Boltarr Wiki

Boltarr is a self-hosted network dashboard for mapping, monitoring, and analyzing your local network — scan subnets with nmap, visualize your topology, track devices and services, watch uptime, get change alerts, and (optionally) chat with an AI assistant that knows your network.

This wiki teaches you how to use Boltarr from install to day-to-day. New here? Follow the path below.

Start here

1. Installation — get Boltarr running (Docker, Proxmox/LXC, Unraid, or manual).
2. First Scan — add a subnet and discover your network in a few clicks.
3. Configuration — every setting explained, with a ready-to-copy sample config.yaml.
4. Troubleshooting — answers to the common "why isn't this working?" questions.

Good to know before you start

• Network scanning needs host networking in Docker. nmap can't discover your LAN from Docker's default bridge network. See Installation — this trips up most first-timers.
• AI is optional. Boltarr works fully without it.
• Your data stays local. Everything lives in a small SQLite database + config file under data/.

Links

• Project: https://github.com/brq-ae/boltarr
• Releases / changelog: https://github.com/brq-ae/boltarr/releases
• Report an issue: https://github.com/brq-ae/boltarr/issues