// Inhalt
Ein Drucker fällt aus. Die erste Frage am Telefon: „Welche IP hatte der eigentlich?" Niemand weiß es genau. Jemand sucht in alten E-Mails. Ein Kollege ruft an, ob er noch was im Kopf hat. Eine halbe Stunde geht für die Diagnose drauf, bevor die eigentliche Reparatur beginnt.
Das ist kein Einzelfall, sondern die Realität in vielen kleinen und mittleren Unternehmen. Die IT-Infrastruktur ist über Jahre gewachsen, Geräte sind hinzugekommen, Mitarbeiter haben gewechselt – und niemand hat eine zentrale Stelle, an der alles dokumentiert ist. Wissen verteilt sich auf Köpfe, Notizzettel und veraltete Excel-Listen.
Strukturierte IT-Inventarisierung löst genau dieses Problem.
Eine Quelle der Wahrheit – das Ziel #
Bei der Inventarisierung geht es nicht darum, Listen zu führen. Es geht darum, eine einzige Stelle zu haben, an der alle Informationen über die IT-Infrastruktur zusammenlaufen: Server, virtuelle Maschinen, Netzwerkgeräte, Clients, Drucker, IP-Adressen, VLANs, Dienste und Supportkontakte.
Diese eine Stelle beantwortet zu jeder Tageszeit drei Fragen:
- Was ist vorhanden?
- Wo läuft es, welche Aufgabe hat es?
- Wer ist zuständig, wenn es kaputtgeht?
Ohne diese Basis arbeitet jeder Techniker im Dunkeln. Mit ihr wird der Drucker-Ausfall von oben zu einer 20-Sekunden-Recherche statt einer 30-Minuten-Suche.
Zwei Werkzeuge, eine Lösung #
Für diese Aufgabe braucht es zwei unterschiedliche Werkzeuge:
- NetBox als strukturierte Datenbasis – maschinenlesbar, API-fähig, exakt
- BookStack als lesbare Dokumentation – für Menschen, mit Kontext und Erklärungen
NetBox weiß, dass der HP LaserJet in München steht und die IP 10.10.20.45 hat. BookStack erklärt, dass es sich um den Drucker im Marketing-Büro im 2. OG handelt, wie er konfiguriert wurde und wer den Wartungsvertrag hält. Beides zusammen ergibt eine vollständige Dokumentation.
Beide Tools sind Open Source, selbst hostbar und vollständig API-fähig – keine Lizenzfallen, keine Hersteller-Bindung.
NetBox – die strukturierte Datenbasis #
NetBox wurde ursprünglich bei DigitalOcean für die Verwaltung der eigenen Rechenzentren entwickelt und ist heute der De-facto-Standard für IT-Inventarisierung. Es deckt zwei Bereiche ab:
IPAM (IP Address Management) verwaltet alle IP-Adressen, Subnetze und VLANs. Prefixes wie 10.10.0.0/16 für den Hauptstandort werden angelegt, in kleinere Subnetze unterteilt, und jede IP-Adresse wird einem Gerät zugewiesen. Doppelvergaben oder verwaiste Adressen fallen sofort auf.
DCIM (Data Center Infrastructure Management) erfasst die physische Infrastruktur: Standorte (Sites), Racks, Geräte (Devices), Interfaces, Stromverteilung, Verkabelung. Jedes Gerät bekommt eine Rolle (Server, Switch, Drucker), eine Plattform (Windows Server 2022, Debian 12) und eine Position im Rack.
Die Stärke liegt in der Verknüpfung: Ein Gerät hat ein Interface, das Interface hat eine IP-Adresse, die IP gehört zu einem Prefix, der Prefix wird zu einem VLAN gemappt, das VLAN gehört zu einem Standort. So entsteht eine vollständig nachvollziehbare Kette von der physischen Hardware bis zur logischen Netzwerkkonfiguration.
API-first – das eigentliche Killer-Feature #
NetBox wurde von Grund auf mit einer vollständigen REST-API entwickelt. Das bedeutet: Jede Information kann automatisiert gelesen, geschrieben und aktualisiert werden.
Ein typisches Python-Skript trägt einen Server in einer einzigen Anfrage ein:
import requests
headers = {"Authorization": "Bearer <token>", "Content-Type": "application/json"}
requests.post("https://netbox.intern/api/dcim/devices/", headers=headers, json={
"name": "SRV-DC01",
"site": 1,
"role": 2,
"device_type": 1,
"platform": 1,
"status": "active",
})
In der Praxis lassen sich so hunderte Geräte aus einer CSV-Datei, aus dem Active Directory oder direkt aus Discovery-Tools in NetBox importieren – reproduzierbar, versionierbar und ohne manuelle Tipparbeit.
Wichtiger noch: Die API funktioniert in beide Richtungen. Andere Systeme greifen auf NetBox-Daten zu und nutzen sie für ihre eigenen Aufgaben:
Konkret bedeutet das im Alltag:
- Zabbix oder Prometheus holen sich die Liste aller zu überwachenden Geräte direkt aus NetBox
- Ansible liest IP-Adressen und Hostnamen für Konfigurations-Rollouts
- Discovery-Tools wie Nmap oder LLDP-Scanner schreiben neu gefundene Geräte automatisch ein
- Ticketsysteme verknüpfen Störungen mit dem konkreten Gerät und seinem Standort
So wird die Inventarisierung nicht zum Selbstzweck, sondern zur Datenbasis der gesamten IT-Automatisierung.
BookStack – die lesbare Dokumentation #
BookStack ergänzt NetBox auf der menschenlesbaren Seite. Während NetBox strukturierte Daten verwaltet, bietet BookStack eine Wiki-Plattform mit klarer Hierarchie:
- Bücher für Themenbereiche, z.B. „IT-Infrastruktur Kunde X"
- Kapitel für Unterthemen, z.B. „Netzwerk", „Server", „Dienste"
- Seiten für konkrete Dokumentationsinhalte mit Text, Tabellen, Code-Blöcken und Bildern
Beim HP LaserJet aus dem Beispiel würde BookStack die Betriebsanleitung, die Rolle im Marketing-Workflow, den Konfigurationsstand und die Kontaktdaten des Wartungspartners enthalten – Informationen, die in einer strukturierten Datenbank wie NetBox nicht abgebildet werden.
Wie NetBox bietet auch BookStack eine vollständige REST-API. Beim Onboarding eines neuen Kunden generiert ein Skript:
- Die Buchstruktur mit allen Kapiteln
- Vorausgefüllte Seiten mit Daten aus NetBox
- Tabellen mit allen Geräten, IPs und Diensten
Die Dokumentation ist damit vom ersten Tag an vollständig – ohne manuelle Copy-Paste-Arbeit.
Was sich konkret verändert #
Mit einer funktionierenden Inventarisierung verschieben sich die Arbeitsweisen im Alltag spürbar – für das Unternehmen und für den IT-Dienstleister.
Im Störungsfall ist sofort klar, was Sache ist. Welches Gerät ist betroffen, welche IP hat es, was läuft darauf, wer ist Ansprechpartner. Was früher 20 Minuten Recherche brauchte, dauert jetzt 20 Sekunden.
Hardware-Planung wird seriös. Statt reaktiv neue Geräte zu kaufen wenn etwas kaputt geht, lässt sich proaktiv planen: Welche Geräte sind älter als fünf Jahre? Welche Lizenzen laufen 2026 aus? Welche Geräte werden nicht mehr genutzt und könnten umverteilt werden? Eine vollständige Inventarliste macht diese Fragen beantwortbar.
Dienstleisterwechsel werden möglich, ohne dass Wissen verloren geht. Die Dokumentation gehört dem Kunden – nicht dem aktuellen Dienstleister. Ein Wechsel oder eine interne Übernahme der IT-Verantwortung wird zu einer organisatorischen, nicht zu einer technischen Frage.
Compliance und Audits werden zur Routine. Datenschutz-Folgenabschätzungen, IT-Audits und Versicherungsfragen lassen sich mit einer vollständigen Inventarliste in kurzer Zeit beantworten – besonders relevant im Gesundheitswesen, in der Finanzbranche und überall dort, wo personenbezogene Daten verarbeitet werden.
Automatisierung wird machbar. Die NetBox-API ermöglicht es, Monitoring, Konfigurations-Management und Ticketsysteme direkt mit aktuellen Infrastrukturdaten zu versorgen. Aus einer reinen Inventarliste wird die Datenbasis für ein automatisiertes IT-Betriebsmodell.
Wie der Einstieg gelingt #
Der Einstieg in NetBox und BookStack ist überschaubarer als viele denken. Der Workflow folgt in der Praxis vier klaren Stufen – von der ersten Bestandsaufnahme bis zur fertigen Dokumentation:
Die wichtigste Weichenstellung liegt in Schritt 2 – der Grundstruktur in NetBox. Eine saubere Definition von Sites, Device Roles, VLANs und Prefixes zahlt sich später vielfach aus. Wer hier sauber arbeitet, profitiert in allen folgenden Schritten.
Nach dem ersten Aufbau folgt der wichtigste Teil: die laufende Pflege. Neue Geräte werden sofort eingetragen, IP-Adressen nie wieder aus dem Kopf vergeben, Änderungen an der Infrastruktur in der Dokumentation nachgezogen. Regelmäßige Audits prüfen, ob NetBox und Realität noch übereinstimmen.
Fazit #
IT-Inventarisierung ist keine einmalige Aufgabe, sondern ein kontinuierlicher Prozess – und eine Investition, die sich im Alltag schnell auszahlt.
Mit NetBox als strukturierter Datenbasis und BookStack als lebender Dokumentation entsteht ein System, das echten Mehrwert liefert: für das Unternehmen, das endlich Überblick über seine eigene IT hat. Für den Dienstleister, der effizienter, schneller und strukturierter arbeiten kann. Und für beide, wenn im Ernstfall schnelles Handeln gefragt ist.
Beide Tools sind Open Source, selbst hostbar und API-first konzipiert. Der Einstieg ist überschaubar, der Nutzen langfristig.
Dieser Artikel entstand im Rahmen eines realen Kundenprojekts. Alle Kundendaten wurden anonymisiert.