BareNOC Appliance Wiki
Welcome to the BareNOC operations appliance — the self-hosted NOC for small and medium businesses. It watches your network, answers questions about it, runs safe diagnostic actions, and tracks everything as tickets, with an AI assistant handling the routine work.
Looking for BareNOC Desktop? That's the IT-tech console for individuals and small MSPs — a separate product with its own docs. See BareNOC Desktop docs (or the product page). This wiki is the Appliance guide.
The workflow at a glance
flowchart LR
U["You"] -->|"chat / web"| QM["Queue Manager (Juniper)"]
QM -->|"opens & tracks tickets"| AI["AI Technician"]
AI -->|"legal & doable"| RUN["Runs action"]
AI -->|"needs human"| HT["Human Tech"]
RUN -->|"verify outcome"| U
AI -->|"needs info"| U
Pages
| Page | What it covers |
|---|---|
| Workflows | The full workflow diagrams (tickets, AI pipeline, discovery, security, backups) |
| Getting Started | Logging in, roles, first steps |
| Tickets | Lifecycle, priorities, approvals, statuses |
| Reports & KPIs | Ticket KPIs (resolution/first-response times), AI spend, digest & EOD emails |
| Devices | Adding, discovering, claiming, and managing devices |
| NOC Agent | The endpoint agent — adopt devices over mTLS, no stored credentials |
| Network Discovery | UniFi sync, ping scans, nmap fingerprinting |
| Link Stability | Flap/outage monitor — the 🔔 toggle, graduated tickets, auto-close |
| Chat Client | The AIM-style desktop chat app |
| Security | Passwords, passkeys, management lockdown |
| Compliance Controls | Toggleable governance panel — LLM egress, MFA, retention, audit, attestation export |
| Network Optimization | Scheduled read-only audit — score + findings for your gear |
| Autonomy Policy | How much the AI may do on its own — per deployment |
| Settings | Overview of every Settings tab (LLM, UniFi, alerts, backups, identity) |
| Updates | Self-update — check, schedule, rollback, progress |
| Support / Bug Report | Redacted diagnostic export for bug reports |
| Backups | App data, VM snapshots, encrypted USB, NAS copy |
Three roles
| Role | What it does |
|---|---|
| Queue Manager (Juniper) | The chat persona you talk to — handles tickets and the queue only; everything else becomes a ticket |
| AI Technician | Reads tickets, judges what's safe/doable, runs approved actions, asks you to verify, escalates to a human |
| Human Tech | Approves and closes escalated tickets — you |
If you're new here, start with Getting Started, then the Workflows page for the big picture.