Netzwerk und Ports

Stand: 19. Oktober 2026. Docunara braucht keine eingehende Verbindung aus dem Internet. Alle Verbindungen nach außen gehen vom Praxisnetz aus; innerhalb des Praxisnetzes spricht der Connector mit dem Mac.

Verbindungen im Überblick

Von	Nach	Port	Zweck
Windows-Connector	Mac (Praxisserver)	TCP 8443 im Praxis-LAN	Befunde, Diktat, Gespräche (HTTPS mit gegenseitiger Zertifikatsprüfung und Signatur)
Windows-Connector	`api.docunara.de`	443, ausgehend	Anmeldung, Geräteverwaltung, Lizenz, Updates
Mac (Praxisserver)	`api.docunara.de`	443, ausgehend	Status, Lizenz, Konfiguration, Update-Prüfung
Browser (jeder PC)	`app.docunara.de`	443, ausgehend	Dashboard
Browser (jeder PC)	`docs.docunara.de`	443, ausgehend	Diese Hilfe
Mac	`huggingface.co` (oder ein bereitgestellter Spiegel)	443, ausgehend	Einmaliger Download der KI-Modelle, rund 25 GB
Mac	NAS	SMB, im LAN	Nur beim Scan-Eingang über ein NAS: der Mac verbindet sich zum NAS, nicht umgekehrt

Die genaue Cloud-Adresse für einen Arbeitsplatz steht in dessen Einrichtungsdatei; die Hostnamen oben entsprechen der Betriebsdokumentation. Filtert Ihre Firewall nach Hostnamen, geben Sie die Hosts für den Praxisserver und die Arbeitsplätze frei und prüfen Sie den Modell-Download beim ersten Mal.

Was nur lokal läuft

Die lokalen Modell- und Dienstports am Mac (8080, 8081) lauschen nur auf dem Mac selbst (Loopback) und sind im Praxisnetz nicht erreichbar.
Die Docunara Verwaltung am Mac ist nur unter 127.0.0.1 erreichbar. Sie lässt sich nur an diesem Mac bedienen.
Der Connector bietet seine Oberfläche nur auf dem eigenen Rechner an (zufälliger Port auf 127.0.0.1, geschützt durch einen kurzlebigen Zugriffsschlüssel).
Der Mac bindet den Port 8443 nur an die private IPv4-Adresse, die bei der Installation gewählt wurde, nicht an alle Schnittstellen. Der Connector akzeptiert nur HTTPS auf 8443 und weist öffentliche und ähnliche Zieladressen ab.

Feste Adresse für den Mac

Empfehlung: DHCP-Reservierung im Router. Der Praxisserver meldet seine Adresse an das Dashboard; die Connectoren holen sie dort ab und müssen sie nicht eintippen. Das Serverzertifikat gehört aber zu dieser Adresse (oder zu einem lokalen Namen wie .local). Wechselt die Adresse:

Der Connector findet die neue Adresse, wenn die bisherige nicht mehr antwortet. Das prüft er gegen das gepinnte Serverzertifikat; ein falsches Ziel wird nie akzeptiert.
Steht die neue Adresse nicht im Serverzertifikat, scheitert die Verbindung mit Absicht (gewolltes Sicherheitsverhalten). Dann muss die Praxis-IT das Zertifikat des Praxisservers erneuern lassen. Prüfen Sie das nach jedem Router-Wechsel.

Der Mac sollte per Kabel im Netz hängen. Die Hilfe beschreibt nur den Kabelbetrieb; ein stabiles Netz ist wichtiger als eine kurze Strecke. Eine Anbindung per WLAN ist nicht Teil der geprüften Anleitung.

Windows-Firewall

Die Windows-Firewall am Arbeitsplatz darf ausgehend TCP 8443 zum Mac nicht blockieren. Eine häufige Ursache für „online, aber nicht lokal verbunden“ ist eine Firewall im privaten Profil, die 8443 blockiert. Auf dem Mac ist keine Freigabe nach außen nötig.

Zeit und Uhr

Die Lizenznachweise der Geräte sind höchstens 48 Stunden gültig; ein Rücksprung der Systemuhr kann die Nutzung früher sperren. Empfehlung: Mac und Windows-Rechner mit einem Zeitserver synchronisieren (Standard in macOS und Windows).

Weitere Netzwerkfragen

Proxy: Eine Proxy-Unterstützung für die Verbindung nach außen ist in der Doku nicht beschrieben. Klären Sie sie vorab mit Docunara, bevor Sie einen Proxy erzwingen.
Fernzugriff: Fernzugriff auf den Mac ist Sache der Praxis-IT. Die Docunara Verwaltung ist bewusst nicht aus dem Netz erreichbar.
Mehrere Netze oder VLANs: Der Connector muss den Mac auf TCP 8443 erreichen; Routing und Freigaben dafür stellt die Praxis-IT.

Siehe auch Arbeitsplätze verbinden und Typische Probleme.