Pub Invest Infrastructure Docs

Internal documentation portal for Pub Invest infrastructure. Docs are organised into areas and applications.

Areas

• Network — connectivity, routing, firewalls, VPN. Also holds the network design docs, config templates, the OPNsense GUI build runbook and the WAN / ISP business.
• Compute / Storage — hosts, virtualisation, storage, backup.
• Monitoring — Zabbix 7 + NetBox + Grafana redesign: architecture and build guides.
• Security — identity, access, secrets, monitoring, policy.

Applications

• Applications — per-app runbooks: mail, web, k8s, dns, ad.

How this site is organised

The navigation is generated automatically from the folder structure under docs/.

• Add a page: drop a .md file into the relevant folder — it appears in the nav, titled from its top # H1.
• Add an application: copy an existing app folder under applications/ and edit the four template pages.
• Reorder or rename a section: add a .nav.yml in that folder.

See the README for running the site locally.