draw.io auf dem Synology NAS installieren: Diagramme und Netzwerkpläne erstellen

Wer IT-Dokumentation betreibt, kommt früher oder später an formalen Netzwerkdiagrammen nicht vorbei. draw.io (früher diagrams.net) ist dafür ein verbreitetes Open-Source-Werkzeug: browserbasiert, mit Bibliotheken für Netzwerk-Icons (Cisco, AWS, Azure, generisch), UML, BPMN und Flussdiagramme. Als Docker-Container auf dem Synology NAS läuft es vollständig im LAN; Diagramme und Exporte verlassen das Netz nicht. Diagramme sind kompakte XML-Dateien, die Sie auf einer NAS-Freigabe ablegen. Für Admins, die ihre Dokumentation ergänzend zu NetBox/IPAM oder einem BookStack-Firmen-Wiki mit versionierbaren Diagrammen unterlegen wollen, ist draw.io eine passende Ergänzung.

Voraussetzungen

• Synology NAS mit DSM 7.2 oder höher
• Container Manager aus dem Synology Package Center installiert
• Mindestens 1 GB freier RAM (empfohlen: 2 GB, Tomcat/JRE ist speicherhungrig)
• Ca. 400 MB freier Speicherplatz auf /volume1 für das Docker-Image
• Netzwerkzugang vom Client-PC zum NAS (LAN oder VPN)
• Webbrowser (Chrome, Firefox oder Edge) am Client-PC
• SMB-Freigabe auf dem NAS als Ablage für die Diagrammdateien

Schritt 1: Ordnerstruktur anlegen

Öffnen Sie die File Station und legen Sie den Ordner /volume1/docker/drawio an. Er nimmt die compose.yaml auf; weitere Unterordner sind ohne HTTPS nicht nötig. Ordner und Berechtigungen erklärt die Grundanleitung Docker-Ordner und Berechtigungen auf dem Synology NAS.

Verifizieren: Der Pfad /volume1/docker/drawio ist in der File Station sichtbar und leer.

Schritt 2: compose.yaml erstellen

Erstellen Sie im Ordner /volume1/docker/drawio die Datei compose.yaml mit folgendem Inhalt. Ersetzen Sie 192.168.1.x durch die IP-Adresse Ihres NAS:

services:
  drawio:
    image: jgraph/drawio:latest
    container_name: drawio
    restart: unless-stopped
    ports:
      - "8080:8080"
      - "8443:8443"
    environment:
      - DRAWIO_SERVER_URL=http://192.168.1.x:8080/
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080"]
      interval: 90s
      timeout: 10s
      retries: 5
      start_period: 30s

Einige Hinweise zu den gewählten Werten:

• Image: jgraph/drawio:latest ist das offizielle Image auf Docker Hub (aktuell 32.6.1, Stand 24.10.2026). Für den Produktivbetrieb schreiben Sie die Version fest, z. B. jgraph/drawio:32.6.1, um unerwartete Updates zu vermeiden. Im Test liefen die Wechsel von 32.4.1 auf 32.5.5 und am 24.10.2026 von 32.5.5 auf 32.6.1 ohne Anpassung der Compose-Datei: Der Container war wieder healthy, der Editor meldete die neue Version, Editor, Offline-Modus (?offline=1) und HTTPS auf Port 8443 antworteten mit 200.
• Port 8080:8080: Interner Tomcat-Port, nach außen durchgereicht. Ist Port 8080 auf dem NAS belegt, wählen Sie einen anderen Host-Port wie 8180:8080 oder 3080:8080.
• Port 8443:8443: HTTPS-Port, nur relevant bei aktivem SSL-Zertifikat. Für reine LAN-Nutzung kann dieser Eintrag entfallen.
• DRAWIO_SERVER_URL: Adresse, unter der der Editor erreichbar ist; mit abschließendem Schrägstrich.
• start_period: 30s: Tomcat braucht beim ersten Start 20–40 Sekunden zur Initialisierung. Die Anlaufzeit verhindert, dass der Healthcheck den Container zu früh als „ungesund“ markiert.
• PUID/PGID: Nicht nötig. Das Image läuft bereits als unprivilegierter Benutzer tomcat (UID 1001).

Verifizieren: Die Datei /volume1/docker/drawio/compose.yaml ist in der File Station sichtbar. Öffnen Sie sie im Texteditor und prüfen Sie, dass die Einrückung aus Leerzeichen besteht (keine Tabulatoren).

Schritt 3: Container Manager – Projekt starten

Wie Sie ein Compose-Projekt anlegen und starten, zeigt die Grundanleitung Container Manager: Docker-Compose-Projekt anlegen, starten und aktualisieren. Konkret für draw.io:

1. Öffnen Sie den Container Manager.
2. Wählen Sie Projekt > Erstellen.
3. Projektname: drawio
4. Pfad: /volume1/docker/drawio
5. Quelle: Vorhandene compose.yaml verwenden (Datei liegt bereits im Ordner)
6. Klicken Sie auf Weiter und dann auf Fertig. Der Container Manager lädt das Image herunter (ca. 388 MB beim ersten Start) und startet den Container.

Verifizieren: Im Container Manager unter Projekt > drawio zeigt der Status nach 30–60 Sekunden Wird ausgeführt an. Unter Container ist der Container drawio mit dem grünen Status-Punkt sichtbar. Der Healthcheck wechselt nach der Anlaufzeit von „Wird gestartet“ auf „Fehlerfrei“.

Schritt 4: draw.io im Browser aufrufen und verifizieren

Öffnen Sie im Browser auf dem Client-PC folgende URL (NAS-IP anpassen):

http://192.168.1.x:8080

Der Parameter ?offline=1 deaktiviert die Anbindung an Cloud-Speicher; die Projektdokumentation empfiehlt ihn als Sicherheitseinstellung:

http://192.168.1.x:8080/?offline=1

Diese URL eignet sich als Browser-Lesezeichen für den täglichen Betrieb.

Verifizieren: Der Editor öffnet sich vollständig, und Sie können eine Form per Drag-and-Drop auf der Zeichenfläche platzieren. Ein leerer Bildschirm deutet auf einen noch startenden Tomcat hin: 20 Sekunden warten und neu laden.

Schritt 5: Netzwerkdiagramm anlegen und auf dem NAS speichern

Als Beispiel erstellen Sie ein einfaches Netzwerkdiagramm.

1. Klicken Sie im Startdialog auf Neues Diagramm erstellen und wählen Sie unter Netzwerk eine Vorlage oder ein leeres Diagramm.
2. In der linken Seitenleiste durchsuchen Sie unter Suchen die Icon-Bibliotheken, z. B. nach „router“, „firewall“ oder „switch“. Die Bibliotheken für Cisco, AWS, Azure und generische Netzwerkelemente sind ohne Zusatzkonfiguration verfügbar.
3. Ziehen Sie Elemente auf die Zeichenfläche, verbinden Sie sie mit Linien und beschriften Sie sie per Doppelklick.
4. Zum Speichern wählen Sie Datei > Speichern unter bzw. Herunterladen. Die Datei landet im Download-Ordner des Browsers. Verschieben Sie sie anschließend per File Station oder Windows-Explorer (SMB-Freigabe) in den gewünschten NAS-Pfad, z. B. /volume1/Dokumente/Netzwerkplaene/.
5. Zum erneuten Öffnen: Datei > Öffnen von > Gerät und die .drawio-Datei auf der NAS-Freigabe wählen.

draw.io speichert Diagramme nicht im Container. Die Dateien liegen beim Anwender, was Backup und Versionierung vereinfacht. Ist die NAS-Freigabe am Client als Netzlaufwerk verbunden, wählen Sie sie beim Speichern direkt als Ziel.

Verifizieren: Die heruntergeladene Datei hat die Endung .drawio und lässt sich in einem Texteditor öffnen; sie enthält XML-Code. Öffnen Sie die Datei erneut in draw.io: Das Diagramm erscheint unverändert.

Schritt 6: Export testen (PDF, PNG, SVG)

Das Image enthält keinen Export-Server mehr (das separate jgraph/export-server ist eingestellt). PNG, JPEG und SVG erzeugt der Browser selbst, PDF entsteht über den Druckdialog des Browsers. Es werden keine Daten an externe draw.io-Server übertragen.

1. Öffnen Sie Ihr Diagramm im Editor.
2. Wählen Sie Datei > Exportieren als > PNG (oder SVG).
3. Passen Sie bei Bedarf Bereich und Skalierung an und klicken Sie auf Exportieren.
4. Für PDF wählen Sie Exportieren als > PDF; es öffnet sich der Druckdialog, dort „Als PDF speichern“ wählen.

Die Option, eine Kopie des Diagramms in die PDF einzubetten, steht dabei nicht zur Verfügung.

Verifizieren: Die PNG-Datei zeigt das Diagramm vollständig, die PDF-Datei öffnet sich fehlerfrei im PDF-Viewer.

Schritt 7: Firewall-Regel für Port 8080 einrichten

Ist die DSM-Firewall aktiv, geben Sie Port 8080 frei. Details: DSM-Firewall auf dem Synology NAS: Ports für Docker-Container freigeben. Kurz: DSM > Systemsteuerung > Sicherheit > Firewall > Regeln bearbeiten > Erstellen, Protokoll TCP, Port 8080, Quell-IP auf Ihr LAN-Subnetz einschränken.

Verifizieren: Rufen Sie http://<NAS-IP>:8080 von einem anderen Gerät im LAN auf; der Editor lädt. Schlägt der Aufruf fehl, prüfen Sie die Firewall-Regeln auf Reihenfolge und Deny-All-Regeln am Ende.

Container-Eckdaten im Überblick

Parameter	Wert	Hinweis
Image	jgraph/drawio:latest	Aktuell 32.6.1 (Stand 24.10.2026); produktiv Version festschreiben
Image-Größe	ca. 388 MB (amd64)	Einmaliger Download; danach kein Internet nötig
Architektur	linux/amd64, linux/arm64	Intel/AMD und ARM64-Synology-Modelle
Port HTTP	8080:8080	Pflicht; Host-Port frei wählbar
Port HTTPS	8443:8443	Optional; nur bei eigenem SSL-Zertifikat
Volumes (Nutzdaten)	keine	Diagramme speichert der Anwender als Datei
Restart-Policy	unless-stopped	Automatischer Start nach DSM-Reboot
PUID/PGID	nicht unterstützt	Läuft als Benutzer tomcat (UID 1001)

Umgebungsvariable	Beispielwert	Pflicht?
DRAWIO_SERVER_URL	http://192.168.1.x:8080/	Empfohlen (Trailing Slash!)
LETS_ENCRYPT_ENABLED	true	Optional; nur bei öffentlicher Domain
PUBLIC_DNS	domain.beispiel.de	Nur bei Let's Encrypt
DRAWIO_CONFIG	JSON-String	Optional; Editor-Konfiguration
DRAWIO_GOOGLE_CLIENT_ID	OAuth-ID	Optional; Google-Drive-Integration

Troubleshooting / Typische Fehler

• Port 8080 bereits belegt: Fehlermeldung beim Projektstart: „port is already allocated“. Ursache: Ein anderer Container oder DSM-Dienst nutzt Port 8080. Fix: In der compose.yaml den Host-Port auf einen freien Port ändern, z. B. 8180:8080. Welche Container welche Ports belegen, zeigt der Container Manager in der Container-Übersicht.
• Healthcheck schlägt sofort an / Container wird neugestartet: Ursache: Tomcat braucht 20 bis 40 Sekunden, eine zu kurze start_period führt zu Fehlalarmen. Fix: start_period: 30s in der compose.yaml sicherstellen. Container neu erstellen.
• Image-Pull schlägt fehl / Timeout: Docker Hub hat gelegentlich Rate-Limits für nicht-authentifizierte Pulls. Fix: Im Container Manager unter Registry > Einstellungen einen Docker-Hub-Account hinterlegen oder einige Minuten warten.
• Fehler „manifest unknown“ beim Image-Pull: Ursache: Veraltetes compose-File mit Tag :alpine oder :debian. Diese Tags existieren seit v16.5.3 nicht mehr. Fix: Tag auf :latest oder eine feste Version wie :32.6.1 ändern.
• PDF-Export öffnet nur den Druckdialog, serverseitiger PNG-Export fehlt: Kein Fehler. Das Image enthält keinen Export-Server mehr; PDF entsteht über „Als PDF speichern“ im Druckdialog, PNG und SVG rendert der Browser. Alte Variablen EXPORT_URL und DRAWIO_SELF_CONTAINED haben keine Wirkung mehr.
• HTTPS mit Let's Encrypt funktioniert nicht im LAN: Ursache: Let's Encrypt benötigt eine öffentlich erreichbare Domain und offene Ports 80/443. Fix: Im LAN HTTP auf Port 8080 nutzen. LETS_ENCRYPT_ENABLED=true nur für externen Betrieb mit eigenem DNS-Namen setzen.
• Hinter einem Reverse Proxy falsche Adressen oder Links: Ursache: DRAWIO_SERVER_URL zeigt noch auf die LAN-Adresse. Fix: Variable auf die öffentliche URL mit abschließendem Schrägstrich setzen und das Projekt neu erstellen.
• Diagramm nach Browser-Schließen verloren: Ursache: draw.io hat kein Auto-Save in ein Container-Volume. Fix: Diagramm immer ausdrücklich über Datei > Speichern unter bzw. Herunterladen sichern.

Häufige Fragen

Werden Diagramme automatisch auf dem NAS gespeichert?

Nein, draw.io speichert keine Nutzdaten im Container-Volume. Diagramme werden als .drawio-XML-Dateien im Browser gehalten. Sie sichern sie ausdrücklich über Datei > Speichern unter bzw. Herunterladen und legen sie auf einer NAS-Freigabe ab.

Was ist der Unterschied zwischen draw.io und Excalidraw auf dem NAS?

draw.io ist das formale IT-Dokumentationswerkzeug: präzises Gitternetz, umfangreiche Icon-Bibliotheken (Netzwerk, AWS, Azure, UML, BPMN), Visio-Import und -Export, versionierbare XML-Dateien. Excalidraw auf dem Synology NAS ist für schnelle, handschriftlich wirkende Skizzen und kollaboratives Whiteboarding optimiert. Beide ergänzen sich: Excalidraw fürs Brainstorming und erste Entwürfe, draw.io für die finale, druckfertige Netzwerkdokumentation.

Kann ich draw.io mit BookStack oder NetBox verbinden?

Nicht per Plugin, aber per Export: Exportieren Sie das Diagramm als PNG oder SVG und betten Sie es als Bild in eine BookStack-Seite ein. Alternativ legen Sie die .drawio-Datei auf einer NAS-Freigabe ab und verweisen auf den Pfad in einem NetBox-Kommentarfeld. Den Zusammenhang zwischen Netzwerkdokumentation, IPAM und Diagrammen beleuchtet die Anleitung zu Netzwerkdokumentation und IP-Adressplan (IPAM).

Funktioniert draw.io ohne Internetverbindung?

Ja. Nach dem einmaligen Image-Download läuft der Container offline. ?offline=1 deaktiviert zusätzlich die Cloud-Speicher-Anbindung. Auch der Export läuft lokal im Browser.

Wie aktualisiere ich draw.io auf die neueste Version?

Im Container Manager das Projekt stoppen, das Image aktualisieren (Projekt > drawio > Aktion > Image aktualisieren) und den Container neu erstellen. Da keine Nutzdaten im Container liegen, geht nichts verloren. Ihre Diagrammdateien auf dem NAS-Share sind vom Container-Lebenszyklus unabhängig.

Welche Synology-Modelle werden unterstützt?

Alle Modelle mit DSM 7.2 und Container Manager. Intel/AMD-CPUs (x86_64/amd64): volle Unterstützung. ARM64-Modelle wie die DS223: ebenfalls, da das Image für amd64 und arm64 gebaut wird. Modelle mit 32-Bit-ARM-CPU unterstützen den Container Manager nicht.

Fazit

draw.io bietet Netzwerk-Icons, UML, BPMN und Visio-Import als einzelner Container auf dem NAS, eingerichtet in etwa 20 Minuten. Es fallen keine Lizenzkosten an, und Diagramme verlassen das eigene Netz nicht. Dass der Container keine Nutzdaten speichert, ist gewollt: Die XML-Dateien liegen beim Anwender, was Backups, Versionierung mit Git und die Einbindung in ein Wiki wie BookStack vereinfacht. Zusammen mit IPAM und Wiki deckt draw.io die Diagramme in der IT-Dokumentation ab.

Weiterführende Anleitungen und Quellen

• NetBox auf dem Synology NAS installieren: IPAM und Netzwerkdokumentation: strukturierte IP-Adressverwaltung als Datenbasis für Netzwerkdiagramme
• BookStack auf dem Synology NAS installieren: das Firmen-Wiki für IT-Dokumentation: draw.io-Exporte als Bilder in Wiki-Seiten einbetten
• Excalidraw auf dem Synology NAS installieren: kollaboratives Whiteboard: informelle Skizzen ergänzend zu formalen draw.io-Diagrammen
• Netzwerkdokumentation und IP-Adressplan (IPAM) erstellen: Konzept und Werkzeugauswahl für vollständige Netzwerkdokumentation
• Nginx Proxy Manager auf der Synology mit Container Manager einrichten: Reverse Proxy und SSL für draw.io und andere Dienste
• Container Manager auf dem Synology NAS: Docker-Compose-Projekt anlegen, starten und aktualisieren

Quellen: Offizielle draw.io-Docker-Dokumentation (drawio.com Blog) · GitHub-Repository jgraph/docker-drawio · Docker Hub jgraph/drawio · Referenz-Anleitung mariushosting.com (fachliche Orientierung, Inhalt eigenständig verfasst)