Infrastructure sources of truth

This page explains where infrastructure information should live. The goal is to avoid copying the same facts into many places and then letting them drift.

Use NetBox for canonical inventory:

• devices and virtual machines
• IP addresses and DNS names
• sites, racks, locations, roles, platforms, and device types
• cabling and switch ports
• primary IPs and VM placement

Wiki pages may mention a few NetBox facts for emergency orientation, but should link back conceptually to NetBox as the source of truth.

Use the wiki for operational knowledge:

• emergency access runbooks
• first checks during incidents
• service ownership and recovery notes
• warnings that are not obvious from inventory
• links between hosts, services, clusters, and procedures

Do not put secrets in the wiki.

Use the password store for credentials and secret material. Wiki pages may name relevant entries when verified, but must not include decrypted contents, tokens, private keys, passwords, or recovery secrets.

Use LibreNMS and Grafana for monitoring state, graphs, and alert context. A wiki page can describe which monitor to check first, but should not duplicate live metrics.

Use GitHub for code, issue tracking, and legacy/out-of-band documentation when useful. GitHub wiki content may be useful historical context, but current operational runbooks should live in this wiki unless there is a specific reason otherwise.