Willkommen

Dieses Handbuch beschreibt, wie TCMSOFT installiert, betrieben und betreut wird: der Server in der Praxis, die Programme an den Arbeitsplätzen, Updates, Datensicherung und Fehlersuche. Wie Ärztinnen, Ärzte, Heilpraktikerinnen, Heilpraktiker und MFA mit TCMSOFT arbeiten, steht im Benutzerhandbuch.

TCMSOFT ist die Praxissoftware für Privatärztinnen und Privatärzte (Abrechnung nach GOÄ). Aus demselben Programm entsteht Salvia Software für Heilpraktikerinnen und Heilpraktiker (Abrechnung nach GebüH); dieses Handbuch gilt für beide. Die Praxisart folgt dem Produkt, siehe Produkt und Praxisart. TCMSOFT läuft als Webanwendung auf einem Server in der Praxis, meist einer NAS mit Docker. Gearbeitet wird im Browser. Für Drucker, Messgeräte, Labor und Scanner kommen kleine Programme an den Arbeitsplätzen dazu, die Agenten. Wie die Teile zusammenhängen, zeigt Aufbau von TCMSOFT.

Für wen dieses Handbuch ist

• Installateure: Systemhäuser und IT-Betreuer der Praxis. Sie richten den Server ein, binden die Arbeitsplätze an und betreuen die Praxis technisch.
• TCMSOFT-Support: Diagnose, Supportfälle und die Auslieferung neuer Versionen.

Fachbegriffe wie Container, Port oder Reverse-Proxy setzt das Handbuch voraus, Wissen über TCMSOFT nicht. Jede Anleitung sagt zuerst, wozu ein Schritt dient. Dann folgt, wie er geht, woran Sie den Erfolg erkennen und was Sie tun, wenn es nicht klappt.

Die fünf Teile

Wegweiser

Neue Praxis einrichten

1. Voraussetzungen prüfen: Prozessor mit AVX, Speicherplatz, Netz.
2. Docker installieren und den SSH-Zugang zum Server einrichten.
3. TCMSOFT einrichten: Sie starten nur den Update-Dienst. Er legt TCMSOFT selbst an.
4. Netzwerk und HTTPS: Reverse-Proxy und Zertifikat einrichten, danach Server__SichereCookies=true in der tcmsoft.env einschalten.
5. Ersteinrichtung der Praxis: erstes Konto, Drucker, Backup-Ziel.
6. An den Arbeitsplätzen mit Druckern den Print Agent installieren und per Code koppeln (der empfohlene Weg zum Drucken) und ab TCMSOFTpro den Prismamed Agent (Messgeräte, Labor, Scans).
7. Die Datensicherung einrichten. Ohne SFTP- oder S3-Ziel entsteht keine automatische Sicherung.

Bestehende Praxis übernehmen

• Daten aus dem bisherigen TCMSOFT: Datenübernahme aus dem bisherigen TCMSOFT.
• Umzug einer bestehenden Installation, etwa vom Mikroserver ohne Docker in den Container oder auf neue Hardware: Datensicherung und Umzug.

Im laufenden Betrieb

• TCMSOFT und die Agenten aktualisieren sich selbst: Updates von TCMSOFT, Updates der Agenten.
• Wenn etwas nicht läuft: Protokolle und Diagnose, Meldungen und ihre Bedeutung, Typische Supportfälle.

Stand dieses Handbuchs

Das Handbuch beschreibt den Stand vom 02.11.2026 mit diesen Versionen:

Version des Update-Dienstes per SSH auf dem Server abfragen:

grep UpdaterVersion <Datenordner>/updater/status.json

Die Ausgabe ist eine Zeile mit "UpdaterVersion" und der Versionsnummer, zum Beispiel 2026.10.7.1.

Hinweis: Ab Update-Dienst 2026.10.7.1 legt der Dienst TCMSOFT nach docker rm -f tcmsoft mit der zuletzt gelaufenen Version neu an, solange deren Image noch auf dem Gerät liegt. Ältere Update-Dienste verhalten sich dabei anders. Einzelheiten stehen unter Updates von TCMSOFT.

Konventionen

• Fett stehen Beschriftungen aus TCMSOFT, genau wie im Programm: Schaltflächen, Felder, Karten und Menüpunkte.
• Menüwege sind mit „›“ getrennt, zum Beispiel Stammdaten › Backup.
• Meldungstexte stehen wörtlich in Anführungszeichen. Ein „…“ darin steht für einen veränderlichen Teil, etwa eine Version oder einen Pfad.
• Schreibmaschinenschrift kennzeichnet Befehle, Pfade, Dateinamen, Ports und Einstellungen.
• Befehle stehen als Codeblock zum Kopieren. Sie laufen per SSH auf dem Server als Administrator, auf einer Synology nach sudo -i, sofern nichts anderes dabeisteht.
• Teile in spitzen Klammern ersetzen Sie vor dem Ausführen, die Klammern eingeschlossen:

• Die Namen der Container tcmsoft und tcmsoft-updater sind fest vorgegeben. Ändern Sie sie nicht.
• Zitatblöcke mit Hinweis enthalten nützliche Zusatzinformationen, Zitatblöcke mit Achtung echte Risiken, etwa Datenverlust.
• Verweise auf das Benutzerhandbuch stehen als Text, zum Beispiel „Benutzerhandbuch › Stammdaten: Praxis › Drucker“.
• Geheimnisse stehen nie in diesem Handbuch, also keine Passwörter, Codes, Schlüssel oder Zugangsdaten. Wo Sie eines brauchen, steht „beim TCMSOFT-Support erfragen“.
• Wege, die nicht getestet sind, sind als solche gekennzeichnet: „nicht getestet – vor dem Einsatz beim TCMSOFT-Support nachfragen“.