Zum Inhalt

Release Notes

Die Release Notes beziehen sich immer auf die Hauptversion des charly-server-Skriptes.

Änderungen während Version 2.13.0

  • 3. November 2026: Die Hilfe für Windows und macOS verwendet feste Abschnittsanker; sämtliche bisherigen Anker-IDs wurden unverändert übernommen und bleiben bei späteren Überschriftenänderungen erhalten (Hilfedokumente 2.13.1).

Version 2.13.0 (3. November 2026)

  • Alle bisher mit 2.12.x versionierten Skripte, Konfigurationsdateien und Hilfedokumente sind auf 2.13.0 vereinheitlicht; die Versionsmanifeste verwenden diesen Stand in testing, vorabversion und release.
  • macOS-Dateien (jeweils Version 2.13.0): charly-server-backup-script.zsh, charly-server-install.zsh, charly-server.zsh, charly-vm-startup.sh, cloud-init.yml, completion-functions.zsh, config-functions.zsh, de.solutio.charly-export.plist, de.solutio.charly-vm.plist, export-functions.zsh, install-functions.zsh, manage-functions.zsh, manage-native-functions.zsh, shared-functions.zsh, system-check-functions.zsh, updater-functions.zsh.
  • VM-Dateien (jeweils Version 2.13.0): vm/backup.yml, vm/connector.yml, vm/docker-network.yml, vm/files/pg_hba.conf, vm/files/postgresql.conf, vm/files/smb.conf, vm/internal.yml, vm/ip_config.yml, vm/main-native.yml, vm/main.yml, vm/openvpn.yml, vm/requirements.yml, vm/script/api-helper.py, vm/script/backup-functions.sh, vm/script/backup_db.sh, vm/script/backup_files.sh, vm/script/charly-run-native.sh, vm/script/charly-run.sh, vm/script/cleanup_docker_conf.py, vm/script/license_control.sh, vm/script/network-functions.sh, vm/script/restic-functions.sh, vm/script/restore_db.sh, vm/script/restore_files.sh, vm/script/shared-functions.sh, vm/script/system-check-functions.sh, vm/wireguard.yml.

Änderungen während Version 2.12.0

  • 2. November 2026: charly-server vm change-email prüft die neue Adresse mit dem pgAdmin-Validator vor Änderungen, erkennt widersprechende Compose-Overrides und bricht bei Stopp- oder Initialisierungsfehlern ab; die Autovervollständigung bietet den Befehl an (vm/script/charly-run.sh 2.12.10, vm/script/shared-functions.sh 2.12.5, completion-functions.zsh 2.12.1).
  • 30. Oktober 2026: VM-Updates verarbeiten auch Windows-1252-kodierte Kommentare in docker.conf ohne Abbruch und bereinigen zu niedrige Speicherlimits auch am Dateianfang mit UTF-8-BOM (cleanup_docker_conf.py 2.12.2).
  • 29. Oktober 2026: charly-server vm change-email aendert nach Passwortbestaetigung die Admin-E-Mail fuer pgAdmin und Dozzle und setzt pgAdmin dabei zurueck; VM-Installation und Befehl pruefen Adressformat und reservierte Domains; Aufbaufehler stoppen den pgAdmin-Reset (manage-functions.zsh 2.12.4, config-functions.zsh 2.12.3, vm/script/charly-run.sh 2.12.10).
  • 28. Oktober 2026: VM-Updates entfernen positive Container-Speicherlimits unter den aktuellen Standardwerten aus docker.conf; gleiche, höhere und unbegrenzte Limits (0) bleiben erhalten, auch mit Anführungszeichen, Inline-Kommentaren und Docker-Einheiten wie mb, gb oder MiB. Normale Container-Neukonfigurationen behalten individuelle Limits bei (vm/main.yml 2.12.5, cleanup_docker_conf.py 2.12.2).
  • 28. Oktober 2026: Neu erzeugte Restic-ISOs enthalten zusätzlich Joliet, damit Windows die vollständigen Repository-Dateinamen für die Wiederherstellung erkennt; bestehende ISOs bleiben unverändert (shared-functions.zsh 2.12.12, vm/script/restic-functions.sh 2.12.4).
  • 28. Oktober 2026: Der Downloadbereich der charly-VM stellt den Windows-Client als charly-Client.zip mit charly-Client_Setup.exe bereit; VM-Meldungen verwenden die Bezeichnung charly-Client (nginx 1.0.46, vm/script/charly-run.sh 2.12.9).
  • 28. Oktober 2026: VM-Backups und native macOS-Exporte melden auch umfangreiche Restic-Repository-Schäden zuverlässig als Warnung in Statusdatei und WebUI; die vollständige Diagnose bleibt im Backup-Log, die Statusmeldung enthält einen kurzen Auszug, und mehrzeilige Meldungen sowie Apostrophe werden korrekt gespeichert (vm/script/restic-functions.sh 2.12.3, export-functions.zsh 2.12.5, shared-functions.zsh 2.12.11).
  • 26. Oktober 2026: Restic-Backups prüfen das Repository nach jeder Sicherung; fehlgeschlagene Prüfungen werden im WebUI als Backup-Warnung gemeldet, beim nächsten Backup wiederholt und setzen die Aufbewahrungsbereinigung aus (export-functions.zsh 2.12.4, vm/script/restic-functions.sh 2.12.1).
  • 26. Oktober 2026: Der macOS-VM-Starter ersetzt bestehende FLG-Aliase nach Prüfung sicher, auch wenn die bisherige Aliasdatei schreibgeschützt ist; gewöhnliche Dateien werden nicht überschrieben (charly.app 1.0).
  • 23. Oktober 2026: Der macOS-VM-Starter installiert und startet Solutio.app wie charly-Starter unter ~/Applications; Protokolle und Überwachung bleiben im bisherigen Support-Ordner (charly.app 1.0).
  • 23. Oktober 2026: Der macOS-Starter entpackt die signierte Anwendung mit ditto, damit die Signaturattribute erhalten bleiben und macOS die installierte Anwendung akzeptiert (charly.app 1.0).
  • 22. Oktober 2026: Der macOS-Starter liest Versionsdateien aus macos/meta_files und setzt den globalen FLG-Alias auf die dortige Solutio.flg; die signierte Anwendung wird weiterhin aus macos/Solutio.zip geladen (charly.app 1.0).
  • 22. Oktober 2026: Der macOS-Starter wird mit der erforderlichen Apple-Events-Berechtigung signiert, damit macOS die Finder-Freigabe zum Erstellen des gemeinsamen Flag-Datei-Alias anfordern kann und Fehler −1743 durch die fehlende Signierberechtigung vermieden wird (charly.app 1.0).
  • 5. Oktober 2026: Lizenzabfragen sind zeitlich begrenzt und protokollieren keine Zugangsdaten oder Lizenzwerte mehr; Fehler beim Anwenden der Lizenzen oder Neustarten der Container bleiben fatal (vm/script/license_control.sh 2.12.1).
  • 1. Oktober 2026: Der macOS-Starter übergibt beim Speichern des SMB-Passworts im Schlüsselbund das erforderliche Konto smbuser; dadurch gelingt die Passwortübernahme aus der Konfiguration (charly.app 1.0).
  • 1. Oktober 2026: Die Selbstaktualisierung akzeptiert auch gültig Ad-hoc-signierte Starter für lokale Tests; Paketprüfsumme, App-Kennung und Codesignatur werden weiterhin geprüft (charly.app 1.0).
  • 1. Oktober 2026: Unveränderte Client-Pakete behalten nach einem Neustart des nginx-Containers dieselbe Prüfsumme; dadurch werden unnötige Starter-Aktualisierungen vermieden (nginx/entrypoint.sh, nginx 1.0.41).
  • 1. Oktober 2026: Der macOS-Starter prüft beim Start die Client-Paket-Prüfsumme, aktualisiert seine signierte App und Konfiguration bei Änderungen automatisch mit bedarfsweiser Administratorfreigabe und startet nach dem sicheren Austausch erneut; bei Austauschfehlern wird der vorherige Stand wiederhergestellt (charly.app 1.0).
  • 30. September 2026: Der macOS-Client lädt die signierte Anwendung aus charly-ablage/macos/Solutio.zip und startet die lokale Solutio.app direkt, prüft Aktualisierungen anhand von Solutio.version und Solutio.build in macos/Solutio.app/Contents/MacOS und erstellt in den Benutzereinstellungen den Finder-Alias de.solutio.flg.global.alias auf die gemeinsame Solutio.flg statt eines SolutioFlg-Symlinks (charly.app 1.0).
  • 28. September 2026: Der macOS-VM-Start ruft docker-action start nicht mehr auf; dadurch kann die Erstinstallation vor der Containerkonfiguration fortfahren (shared-functions.zsh 2.12.8).
  • 28. September 2026: Das VM-Ablageimage kann bei der Konfiguration auch in geschützten Ordnern liegen; die Pfade für VM-Dateien und das Datenbankimage bleiben eingeschränkt. Der Hinweis zum automatischen VM-Start erscheint nur beim Pfad für VM-Dateien, der Hinweis zum täglichen Export nur bei der Exportkonfiguration (config-functions.zsh 2.12.2, shared-functions.zsh 2.12.7, export-functions.zsh 2.12.3).
  • 23. September 2026: VM-Installation, nativer Export und Wiederherstellung benötigen auf unterstützten Macs kein Homebrew mehr: Die ungenutzte yq-Abhängigkeit entfällt; benötigte Hilfsprogramme werden geprüft aus dem solutio CDN geladen, auch bei nächtlichen Backups nach einem Skript-Update direkt vor der jeweiligen Operation; Bereitstellungsfehler werden auch bei einfachen Backups als Exportfehler gemeldet, verwendete Hilfsprogramme samt Pfad und CDN-Paketversion im Log protokolliert, und auf älterem macOS werden vorhandene Hilfsprogramme aus dem PATH (z. B. MacPorts) vor einem interaktiven Homebrew-Rückfall weiterverwendet; fehlendes Homebrew wird bei Bedarf eingerichtet (charly-server.zsh 2.12.3, shared-functions.zsh 2.12.6, install-functions.zsh 2.12.3, export-functions.zsh 2.12.2, manage-native-functions.zsh 2.12.4, manage-functions.zsh 2.12.3, config-functions.zsh 2.12.1, system-check-functions.zsh 2.12.2).
  • 21. September 2026: Die VM leitet aktive Mandantennummern aus der Zeilenposition in Mandanten.flg ab; inaktive Zeilen bleiben bei der Nummerierung berücksichtigt (vm/main.yml 2.12.2).
  • 3. September 2026: VM-Installationen und VM-Updates speichern Betriebssystemname, Version, Buildnummer und Architektur des macOS-Hosts in der VM und starten anschliessend den solutio-service neu (manage-functions.zsh 2.12.1, shared-functions.zsh 2.12.4, system-check-functions.zsh 2.12.0, vm/script/charly-run.sh 2.12.4, vm/script/shared-functions.sh 2.12.3, vm/script/api-helper.py 2.12.0).
  • 2. September 2026: VM-Installationen laden die Hardening-Rollen aus dem solutio CDN statt direkt von GitHub und fragen daher nicht nach GitHub-Anmeldedaten (vm/requirements.yml 2.12.1).
  • 31. August 2026: Nach einer nativen oder VM-Datenbankwiederherstellung wird die aus dem Backup übernommene Systemkennung gelöscht, damit das Zielsystem die Kennung des Quellsystems nicht weiterverwendet (manage-native-functions.zsh 2.12.3, vm/script/restore_db.sh 2.12.2, vm/script/shared-functions.sh 2.12.3).
  • 28. August 2026: Die VM-Speicherplatzbereinigung leert neben den Audit-Ereignissen auch die Aidbox-Coverage-Historie (vm/script/charly-run.sh 2.12.4).
  • 26. August 2026: Fehler beim lokalen VM Backup wurde behoben (vm/script/backup-functions.sh 2.12.4).
  • 13. August 2026: Native und VM-Backups melden nicht-kritische Probleme einheitlich als Warnung; konfigurierte, nicht erreichbare SMB-Ziele beenden VM-Backups als Fehler (export-functions.zsh 2.12.1, vm/script/backup-functions.sh 2.12.2).
  • 11. August 2026: Beim Start der charly-VM werden die Datenlaufwerke abgewartet und geprüft; ohne korrekt eingebundene Laufwerke bleibt Docker gestoppt und der Start wird als Fehler gemeldet (shared-functions.zsh 2.12.1, cloud-init.yml 2.12.1, vm/main.yml 2.12.1, vm/script/shared-functions.sh 2.12.1).
  • 4. August 2026: Bestehende charly-VMs verwenden auf älteren macOS-Versionen weiterhin QEMU aus Homebrew; macOS 15 oder neuer wird nur für neue VM-Installationen vorausgesetzt (manage-functions.zsh 2.12.0, shared-functions.zsh 2.12.3).
  • 31. Juli 2026: Das gebündelte QEMU enthält nun das VirtIO-EFI-ROM, damit die charly-VM auf Apple-Silicon-Macs startet (charly-server.zsh 2.12.1, install-functions.zsh 2.12.1, manage-functions.zsh 2.12.0, shared-functions.zsh 2.12.3).

Version 2.12.0 (10. August 2026)

  • Alle charly-server-Komponenten verwenden nun den einheitlichen Versionsstand 2.12.0. Die bereits während Version 2.11.3 ausgelieferten Änderungen bleiben im folgenden Abschnitt dokumentiert.
  • 13. August 2026: VM-Installationen laden die lokal konfigurierte Debian-12-Basisimage-Version aus dem solutio Vendor-Artefaktbereich (charly-server.zsh 2.11.3, install-functions.zsh 2.11.1, shared-functions.zsh 2.11.4).
  • 12. August 2026: Verwendbare native und VM-Backups mit Warnungen werden als „Erfolgreich mit Warnung“ gemeldet (export-functions.zsh 2.11.2, vm/script/backup-functions.sh 2.11.5).

Änderungen während Version 2.11.3

  • 4. August 2026: Verwendbare native und VM-Backups mit Warnungen werden als „Erfolgreich mit Warnung“ gemeldet (export-functions.zsh 2.11.2, vm/script/backup-functions.sh 2.11.5).
  • 29. Juli 2026: Nach einer Wiederherstellung wird der Ordner ablage automatisch in Ablage umbenannt (vm/script/shared-functions.sh 2.11.14).
  • 28. Juli 2026: Die charly-VM startet bei einer vorübergehend fehlenden Internetverbindung nicht mehr automatisch im Offline-Modus (shared-functions.zsh 2.11.4).
  • 22. Juli 2026: Die Erkennung einer erfolgreichen WireGuard-Verbindung wurde verbessert (vm/script/network-functions.sh 2.11.2).
  • 16. Juli 2026: Die Installationshinweise zu DHCP, Speicherplatz und nicht unterstützten exFAT-Datenträgern wurden ergänzt.
  • 14. Juli 2026: Interne und externe VM-Backups werden robuster konfiguriert; leere Hostnamen lassen nur das interne Backup aktiv (vm/script/charly-run.sh 2.11.9).
  • 6. Juli 2026: KIM-Adressen mit Hostnamen, localhost oder lokalen IP-Adressen werden beim Export zuverlässiger in eine für die VM erreichbare IP-Adresse umgewandelt (export-functions.zsh 2.11.2, shared-functions.zsh 2.11.4).
  • 25. Juni 2026: Bei einer VM-Installation ohne ISO-Datei wird automatisch die charly Originalversion eingerichtet; ein vorhandenes Backup kann anschließend wiederhergestellt werden (database 1.0.5).

Version 2.11.3 (9. Juni 2026)

Verbesserungen

  • Die Logfiles der Docker Container bleiben auch nach einem Update, und damit länger als ein Tag erhalten.

Version 2.11.2 (28. April 2026)

Fehlerbehebungen

  • Ein möglicher Fehler beim Konfigurieren des VM Backups wurde behoben

Verbesserungen

  • QM Dokumente werden bei einem Restore geprüft und mögliche falsche Ablage-Pfade werden automatisch korrigiert.

Version 2.11.1 (13. April 2026)

Fehlerbehebungen

  • Ein Rechte-Problem mit charly-server.zsh wurde behoben. Wenn es versehentlich dem root User gehört, wird jetzt automatisch der aktuelle User gesetzt.

Version 2.11.0 (30. März 2026)

Änderungen

  • Passwort-Handling erweitert: Neues show-passwords für die VM
  • Export und Deaktivierung verbessert: export deactivate deaktiviert nun auch den Backup-Job des Altsystems; Export-Dialoge und Passwortquellen wurden robuster gemacht.
  • Restore und Prüfungen korrigiert: Native Datenbank-Restores sowie TOAST-/LOB-Prüfungen verhalten sich zuverlässiger.

Verbesserungen

  • VM robuster: VPN-/Konnektor-Konfigurationen werden sauberer übernommen; IP-Adressbehandlung und SMB-/SolutioFlg-Handling wurden verbessert.
  • Sicherheit und Logging: Passwörter landen nicht mehr im Credential Manager oder in Logs; Cloud-Init-Ausgaben sind besser sichtbar.

Version 2.10.2 (9. Februar 2026)

Verbesserungen

  • Restic-Backup Robustheit: Verbesserte Behandlung von temporären Dateien und Backup-Warnungen
  • Erweiterte Ausschluss-Muster für temporäre und System-Dateien (.DS_Store, Thumbs.db, Office-Temp-Dateien, etc.)
  • Backup mit Warnungen (Exit Code 3) wird als Warnstatus gewertet statt als Fehler
  • Warnungen werden gesammelt und im Backup-Status angezeigt
  • Konsistentes Verhalten zwischen macOS und Windows
  • VM-Updates: Java-Runtime in der VM auf Temurin JRE 25 aktualisiert; TI-Routing auf die PU-Route fokussiert.

Version 2.9.1 (12. Januar 2026)

Verbesserungen

  • Postgres 16 Pfaderkennung: Zusätzliche Heuristik für alternative Installationspfade (/Library/solutio_postgres/16)
  • Logging: Der vollständige charly-server-Befehl wird nun am Anfang des Logfiles protokolliert
  • VM charly-run Wrapper: charly-run kann nun direkt von überall in der VM aufgerufen werden
  • Desktop-Verknüpfungen: Neue Icons und Namen für VM-Desktop-Shortcuts

Version 2.9.0 (29. Dezember 2025)

Fehlerbehebungen

  • Apple Silicon VMs: Korrektur des QEMU CPU-Typs für Apple Silicon Macs mit HVF-Virtualisierung. VMs starten nun zuverlässig auf allen Apple Silicon Macs.
  • Verbesserte Fehlerbehandlung bei VM-Setup: Klare Fehlermeldung statt Hängen bei nicht verfügbaren solutio-service Versionen

Version 2.8.10 (20. Dezember 2025)

Neue Features

  • charly-server vm get-logs sammelt automatisch Host- und VM-Logs in einem tar.gz-Archiv für die Support-Analyse.
  • charly-server export deactivate deaktiviert nach dem Export das Altsystem und ersetzt damit den bisherigen Migrationsschritt export migration.
  • Backups hinterlegen ihren Status zusätzlich im Ordner backup_messages (native & VM), sodass Erfolg/Meldungen schneller nachvollziehbar sind.

Verbesserungen

  • Erweiterter vm system-check prüft jetzt auch Mount-Status von charly-files/charly-data, SMB-Service/Port 445 sowie DB-Connectivity aus der VM und vom macOS-Host.
  • Restic-Backups sind robuster: Einsatz nur noch ab macOS 13, temporäre Export-Ordner werden vor dem Backup geleert und Ordnernamen korrekt vergeben.
  • SMB-Handling verbessert: Automatisches Trennen nach Backup/Restore und Konnektivitätsprüfung mit Port-Check vor Ping, damit Firewalls ohne ICMP nicht blockieren.
  • Zugangsdaten werden sicherer verwaltet: SMB-Passwörter landen im macOS-Schlüsselbund und werden bei Export/Restore automatisch genutzt.

Fehlerbehebungen

  • Temporäre Export-Verzeichnisse und Restic-Strukturen werden vor/nach Backups bereinigt, fehlerhafte .sql-Ordnernamen entfallen.
  • Status- und Versionsausgaben spiegeln den gewählten Kanal korrekt wider.

Version 2.8.0 (21. November 2025)

Neue Features

  • Einführung einer neuen, inkrementellen Backup Variante. Diese steht für die klassische und die charly-VM zur Verfügung
  • Neben der VM Installation mit einer ISO Datei kann jetzt auch ohne ISO Datei installiert und das auf dem Quell-System erzeugte inkrementelle Backup in der VM restauriert werden.
  • Die Umstellung von einer klassischen Installation auf die charly-VM, die Dr. Flex verwendet, wurde automatisiert.
  • Die Dokumentation wurde deswegen überarbeitet.

Version 2.7.0 (1. Oktober 2025)

Nur kleiner Bugfixes und Optimierungen

Version 2.6.0 (21. August 2025)

Neue Features

Änderungen

  • Der solutio service läuft jetzt nicht mehr als Container, sondern direkt in der VM. Siehe Solutio Service
  • Die Installation der VM wurde verbessert. Es muss jetzt kein Festplattenvollzugriff mehr eingerichtet werden. Damit läuft die Installation nun ohne Unterbrechung durch.

Version 2.5.0 (27. Juni 2025)

  • charly-server manage wurde in charly-server vm umbenannt. Beim Verwenden des alten Kommandos erscheint ein Hinweis.
  • charly-server vm set-connector ermöglicht die Konfiguration einen Konnektors, auch mit einem VPN Gateway. Siehe Telematikinfrastruktur (TI) für charly VM
  • Die Passwörter der charly VM können geändert werden. Siehe Passwort-Management

Version 2.4.0 (30 Mai 2025)

Neue Features

  • automatische Aktivierung von Aidbox/Fhir für das Aufgabenmanagement

Änderungen

  • kleiner Bugfixes

2.3 (2025-04-09)

  • Export/Backup einer klassischen charly server Installation via charly-server export normal

1.2 (2025-02-27)

  • Umstellung auf neues Backup-Konzept
  • charly-server manage system-check erzeugt einen System-Bericht

1.1 (2025-01-03)

  • Umstellung auf zentrale Installation der Skripte unter /usr/local/bin/charly-server mittels charly-server-install.zsh
  • "charly-server" fungiert als zentrales Kommando nach der Installation und kann von jedem Pfad aus aufgerufen werden
  • "charly-server" zeigt beim Start die Skript Version an und in welchem Environment das Skript ausgeführt wird
  • charly-server manage switch-environment vorabversion wechselt auf die Vorabversion der Skripte. Hiermit wird nicht der Kanal der charly Software geändert
  • Abfrage der Praxisgröße zum Setzen der Default Werte für charly-server install.
  • Überprüfung der Systemvoraussetzungen basierend auf der Praxisgröße. Dies beinhaltet auch die Geschwindigkeit des Netzwerkanschlusses des Servers.
  • charly-server manage logs zeigt die Logfiles der Container in der Shell an.
  • Unterstützung individueller Festplattengrößen (Konfigurierbar über charly-server install)
  • Speichern der Konfiguration und Passwörter unter $HOME/.config/charly-server
  • Passwörter werden bei der Installation automatisch generiert und vorgeschlagen. Dies können auch bei einer erneuten Installation der VM genutzt werden.
  • charly-server manage uninstall entfernt charly-server und bietet auch an die VM mit allen Daten (und ggf. Konfiguration) zu entfernen.
  • charly-server manage uninstall-vm entfernt nur die VM (und ggf. Konfigurationsdateien)

Technische Änderungen

  • Umstellen des individuellen Export Skriptes export-solutio-data.zsh auf export-functions.zsh
  • Umstellen des individuellen Export Skriptes install-vm.zsh auf install-functions.zsh
  • Umstellen des individuellen Export Skriptes manage-vm.zsh auf manage-functions.zsh
  • Das Environment kann bei der Installation angegeben werden (charly-server-install.zsh -Environment Vorabversion). Ein Angabe beim Aufruf von charly-server ist nicht mehr vorgesehen.
  • Im "Development" Environment werden Debug Meldungen in Magenta ausgegeben.
  • Automatische Vorauswahl des Netzwerkanschlusses basierend auf Geschwindigkeit bei der VM Installation. Anzeigen von Anschlussdetails.

1.0.14 (2024-11-01)

  • charly-server export prepare bereitet das native System für den Export vor durch Installation von brew und weiteren Paketen
  • charly-server install preparebereitet das Host System für die Installation der VM vor (brew/qemu).
  • Das Passwort des SSH Schlüssels wird zum SSH Agent hinzugefügt so dass man nicht bei jedem Kommando das SSH Passwort angeben muss.
  • Es kann überprüft werden ob die IP des KIM Client Moduls von der VM erreichbar ist.
  • Speichern der Passwörter auf der Festplatte

Version: 2.13.1 Datum der letzten Aktualisierung: 03.11.2026