Overview¶
Factum is a hub, not a source of truth for everything. Upstream systems (NetBox, Lime CRM, BECS) sync into Factum's database. Downstream systems (DNS, Icinga, LibreNMS, Oxidized, Prometheus) are generated from Factum.
These pages describe the web GUI. They ship inside the factum2-web
binary, so they match the version you are logged into — not whatever is
currently on GitHub.
What you will see¶
| Area | Menu | Typical use |
|---|---|---|
| Dashboard | Home | Welcome plus admin-configured shortcut links |
| Customers / Contacts / Sites | Organization | Only if Organization is enabled under Admin → Settings → Factum |
| Services / Config / Maintenance | Provisioning | Capacity services, config tree (CLI / parameters), optical maintenance |
| Racks / Floor plans / Connections | Infrastructure | Room drawings, rack elevations, direct cables |
| Network map / Configuration / Devices / Interfaces / Interface types / Oxidized | DCIM | Inventory, topology, live configuration, config backups |
| Packet capture / Software | Tools | Port mirror and NOS images |
| Prefixes / IP addresses | IPAM | Only if IP address management is enabled |
| DNS | Services | Zones, DNS templates, SOA templates, and DNSSEC policies, as tabs. Only if DNS zone editor is enabled |
| Certificates | Services | Certificates, accounts, and challenges, as tabs. Only if Certificates is enabled (Destinations) |
| Overview / scheduler | Jobs | Trigger and watch syncs. Overview, Status, and Workers are tabs |
| Directory / Settings / Sources / Destinations / Services | Admin | Administrators only. Directory is the first entry |
Some entries appear only when the matching feature is on (Oxidized, Software, optical, IPAM, organization, DNS zone editor, DHCP). Turning a feature off hides the UI; it does not delete stored data.
Roles¶
A user with no role only sees the dashboard, their profile, and this documentation. Viewer can read; operator can write; admin can change settings, users, and workers.