MC4Y-Produktivitätssuite – Installation Schritt für Schritt
============================================================

Fassung 0.4.15 · Erprobungsfassung · freie Software (GPL-3.0-or-later, siehe LIZENZ.txt)
MY COACHING FOR YOU, Peter Hoenig – https://www.my-coaching4you.de/
English version: INSTALL.txt

Diese Anleitung ist für Menschen ohne IT-Kenntnisse geschrieben. Lesen Sie zuerst Abschnitt 1. Danach
brauchen Sie nur den Abschnitt, der zu Ihrem Weg passt.

So ist sie aufgebaut: Jeder Schritt hat eine Nummer und genau eine Handlung. Was Sie anklicken oder
eintippen, steht in „Anführungszeichen“ – genau so, wie es auf dem Bildschirm steht. Unter vielen Schritten
steht „Sie sehen jetzt …“; sieht es bei Ihnen anders aus, hilft meist der Hinweis darunter oder
Abschnitt 9 „Häufige Probleme“.


INHALT
   1. Welcher Weg passt zu mir?
   2. Was Sie brauchen
   3. Weg A – Nur im Browser (Windows, Mac, Linux)
   4. Weg B – Die Suite auf diesem Windows-Rechner
   5. Weg C – Die Suite auf diesem Mac
   6. Weg D – Server im Firmennetz (für die Person, die den Server betreut)
   7. Das erste Konto anlegen
   8. So prüfen Sie, ob es geklappt hat
   9. Häufige Probleme
  10. Aktualisieren
  11. Entfernen (deinstallieren)
  12. Die Desktop-Taskleiste
  13. Für Fachleute: Befehle und Optionen
      Haftung und Datenschutz


1. Welcher Weg passt zu mir?
----------------------------
Gehen Sie die Fragen der Reihe nach durch. Beim ersten „Ja“ haben Sie Ihren Weg.

  Frage 1: Möchten Sie die Werkzeuge allein nutzen oder erst einmal ausprobieren – und Ihre Arbeit
           als Dateien speichern, so wie ein Textdokument?
           → Ja: WEG A – Nur im Browser. Das ist am einfachsten: keine Installation, kein Kennwort,
             kein Internet nötig, sobald die Dateien auf Ihrem Rechner sind. Geht auf jedem
             Windows-Rechner, jedem Mac (auch älteren) und unter Linux.

  Frage 2: Möchten Sie die ganze Suite für sich allein – mit Anmeldung, gemeinsamer Ablage für alle
           Werkzeuge, Dokumentenablage, Wiki, Kalender, Aufgaben und täglicher Sicherung?
           → Windows 10 oder 11: WEG B.
           → Mac mit macOS 12 (Monterey) oder neuer: WEG C.
           → Linux: Abschnitt 6.3 (für Fachleute).

  Frage 3: Soll ein ganzes Team gemeinsam mit der Suite arbeiten?
           → WEG D – Server im Firmennetz. Das richtet die Person ein, die Ihre Server betreut.

Der Unterschied in zwei Sätzen: Bei Weg A arbeitet jedes Werkzeug für sich mit Ihren eigenen Dateien.
Bei den Wegen B, C und D läuft die Suite unsichtbar im Hintergrund; Sie melden sich im Browser an,
und alle Werkzeuge speichern in eine gemeinsame, täglich gesicherte Ablage.

Sie können klein anfangen: Weg A jetzt, die Suite später. Ihre Dateien aus Weg A lassen sich in der
Suite wieder öffnen.


2. Was Sie brauchen
-------------------
Für alle Wege
  - Einen aktuellen Browser: Microsoft Edge, Google Chrome, Mozilla Firefox oder Safari.
  - Internet zum Herunterladen. Weg A braucht danach kein Internet mehr; bei den Wegen B und C lädt
    die Installation zusätzlich PHP herunter (15 bis 35 MB). PHP ist die Programmiersprache, in der
    die Suite läuft.
  - Zeit: Weg A etwa 5 Minuten, Weg B oder C etwa 15 Minuten.

Für Weg B (Windows)
  - Windows 10 oder 11. So sehen Sie nach: Drücken Sie gleichzeitig die Windows-Taste (das Fenster-
    Symbol unten links auf der Tastatur) und die Taste R. Tippen Sie „winver“ und drücken Sie die
    Eingabetaste. Sie sehen jetzt ein Fenster „Info über Windows“ mit „Windows 11“ oder „Windows 10“.
  - Das Kennwort eines Administratorkontos (ein Konto, das Programme installieren darf). Haben Sie den
    Rechner selbst eingerichtet, ist das meist Ihr eigenes Anmeldekennwort.
  - Etwa 1 GB freien Speicherplatz.

Für Weg C (Mac)
  - macOS 12 (Monterey) oder neuer. Es geht mit Intel-Macs (zum Beispiel einem MacBook Pro von 2019)
    und mit Macs mit Apple-Chip. Homebrew, Xcode oder andere Entwicklerwerkzeuge brauchen Sie NICHT.
    So sehen Sie die macOS-Fassung nach:
      1. Klicken Sie ganz oben links auf das Apple-Symbol (den kleinen Apfel).
      2. Klicken Sie auf „Über diesen Mac“.
         Sie sehen jetzt ein Fenster mit dem Namen der Fassung (zum Beispiel „macOS Sonoma“) und
         darunter „Version 14.7“. Die erste Zahl muss 12 oder größer sein.
    Steht dort 10.15 (Catalina) oder 11 (Big Sur): Ihr Mac lässt sich vielleicht kostenlos aktualisieren.
    Sehen Sie im Apple-Menü unter „Systemeinstellungen“ › „Softwareupdate“ nach. Ein MacBook Pro von 2019
    zum Beispiel kann macOS 15 (Sequoia) bekommen. Geht das nicht, nehmen Sie Weg A – der läuft auf
    jedem Mac.
  - Das Kennwort, mit dem Sie sich am Mac anmelden. Ihr Benutzerkonto muss Administrator sein; das ist
    beim ersten Konto eines Macs immer so.
  - Etwa 1 GB freien Speicherplatz.

Woher bekomme ich die Dateien?
  Alle Dateien liegen auf der Website von MY COACHING FOR YOU (www.my-coaching4you.de) im Bereich
  „Experimentell – zum Ausprobieren“ (später unter „Ressourcen und Downloads“):
    mc4y-werkzeuge.zip    für Weg A (nur die Werkzeuge, ohne Suite)
    mc4y-suite.zip        für die Wege B, C und D (die ganze Suite; diese Anleitung liegt darin)
    mc4y-taskleiste.zip   die Desktop-Taskleiste (Abschnitt 12)


3. Weg A – Nur im Browser
-------------------------
Sie brauchen die Datei „mc4y-werkzeuge.zip“ (siehe Abschnitt 2, „Woher bekomme ich die Dateien?“).
Unter Windows geht es auch mit dem grafischen Installer dieses Pakets: Folgen Sie Abschnitt 4 bis
Schritt 10 und klicken Sie in Schritt 11 auf „Nur im Browser (am einfachsten)“.

3.1 Unter Windows
  1. Laden Sie „mc4y-werkzeuge.zip“ herunter.
     Ihr Browser legt die Datei in den Ordner „Downloads“.
  2. Öffnen Sie den Explorer: Drücken Sie gleichzeitig die Windows-Taste und E.
  3. Klicken Sie links auf „Downloads“.
  4. Klicken Sie mit der rechten Maustaste auf „mc4y-werkzeuge“ (bzw. „mc4y-werkzeuge.zip“).
  5. Klicken Sie auf „Alle extrahieren …“.
     Sie sehen jetzt das Fenster „ZIP-komprimierte Ordner extrahieren“.
     Tipp: Sollen die Werkzeuge an einem festen Ort liegen, zum Beispiel in „Dokumente“, wählen Sie das
     jetzt über „Durchsuchen …“. Später sollten Sie den Ordner nicht mehr verschieben.
  6. Klicken Sie auf „Extrahieren“.
     Sie sehen jetzt einen Ordner mit einem Unterordner „MC4Y-Werkzeuge-0.4.15“.
  7. Doppelklicken Sie auf „MC4Y-Werkzeuge-0.4.15“.
  8. Doppelklicken Sie auf „index“ (bzw. „index.html“).
     Sie sehen jetzt im Browser die Seite „MC4Y-Werkzeuge“ mit allen Werkzeugen.
     Fragt Windows, womit die Datei geöffnet werden soll: Wählen Sie „Microsoft Edge“ oder „Google Chrome“.
  9. Legen Sie ein Lesezeichen an: Drücken Sie Strg + D und klicken Sie auf „Fertig“.
 10. Klicken Sie auf ein Werkzeug. Es öffnet sich im Browser.

3.2 Auf dem Mac
  1. Laden Sie „mc4y-werkzeuge.zip“ herunter.
  2. Öffnen Sie den Finder (das blau-weiße Gesicht im Dock) und klicken Sie links auf „Downloads“.
  3. Sehen Sie dort „mc4y-werkzeuge.zip“, doppelklicken Sie darauf.
     Sie sehen jetzt einen Ordner „MC4Y-Werkzeuge-0.4.15“.
     (Safari packt die Datei oft schon selbst aus – dann ist der Ordner bereits da und die ZIP-Datei fehlt.
     Das ist in Ordnung.)
  4. Tipp: Ziehen Sie den Ordner jetzt an seinen festen Platz, zum Beispiel in „Dokumente“. Später sollten
     Sie ihn nicht mehr verschieben.
  5. Doppelklicken Sie auf den Ordner „MC4Y-Werkzeuge-0.4.15“.
  6. Doppelklicken Sie auf „index.html“.
     Sie sehen jetzt im Browser die Seite „MC4Y-Werkzeuge“.
  7. Legen Sie ein Lesezeichen an: Drücken Sie cmd + D (die Befehlstaste ⌘ und D) und klicken Sie auf
     „Hinzufügen“.
  8. Klicken Sie auf ein Werkzeug.
  Kein Terminal, kein Kennwort, kein PHP – das geht auf jedem Mac, auch mit älterem macOS.

3.3 Unter Linux
  1. „mc4y-werkzeuge.zip“ herunterladen.
  2. Im Dateimanager mit der rechten Maustaste auf die Datei klicken und „Hier entpacken“ wählen.
  3. Im neuen Ordner doppelt auf „index.html“ klicken.

So arbeiten Sie mit den Werkzeugen
  - „Speichern“ im Werkzeug legt Ihre Arbeit als Datei ab. In Chrome und Edge wählen Sie den Ort selbst;
    in Safari und Firefox landet die Datei im Ordner „Downloads“. „Öffnen“ holt sie wieder.
  - Zwischenstände merkt sich der Browser. Ihre eigentliche Arbeit sind aber die gespeicherten Dateien –
    sichern Sie diese wie andere Dokumente auch.
  - Oben rechts in jedem Werkzeug schalten Sie mit „DE | EN“ zwischen Deutsch und Englisch um.
  - Es wird nichts übertragen.


4. Weg B – Die Suite auf diesem Windows-Rechner
-----------------------------------------------
Sie brauchen die Datei „mc4y-suite.zip“ und das Kennwort eines Administratorkontos (Abschnitt 2).

Teil 1: Paket herunterladen und auspacken
  1. Laden Sie „mc4y-suite.zip“ herunter.
     Ihr Browser legt die Datei in den Ordner „Downloads“.
  2. Öffnen Sie den Explorer: Drücken Sie gleichzeitig die Windows-Taste und E.
  3. Klicken Sie links auf „Downloads“.
  4. Klicken Sie mit der rechten Maustaste auf „mc4y-suite“ (bzw. „mc4y-suite.zip“) und dann auf
     „Eigenschaften“.
     Sie sehen jetzt das Fenster „Eigenschaften von mc4y-suite.zip“.
  5. Steht unten bei „Sicherheit“ der Satz „Die Datei stammt von einem anderen Computer …“: Setzen Sie
     dort das Häkchen bei „Zulassen“.
     Steht dort nichts davon, ist nichts zu tun.
     (Warum? Sonst warnt Windows später bei jedem Schritt, weil die Dateien aus dem Internet stammen.)
  6. Klicken Sie auf „OK“.
  7. Klicken Sie wieder mit der rechten Maustaste auf „mc4y-suite“ und dann auf „Alle extrahieren …“.
     Sie sehen jetzt das Fenster „ZIP-komprimierte Ordner extrahieren“.
  8. Klicken Sie auf „Extrahieren“.
     Sie sehen jetzt einen Ordner mit einem Unterordner „MC4Y-Suite-0.4.15“.
  9. Doppelklicken Sie auf „MC4Y-Suite-0.4.15“.
     Sie sehen jetzt unter anderem „Installer-starten“, „INSTALLATION“ und die Ordner „app“, „install“
     und „public“.

Teil 2: Den Installer starten
 10. Doppelklicken Sie auf „Installer-starten“ (Typ „Windows-Batchdatei“).
     Erscheint ein blaues Fenster „Der Computer wurde durch Windows geschützt“: Klicken Sie auf „Weitere
     Informationen“ und dann auf „Trotzdem ausführen“. (Das kommt nur, wenn Schritt 5 nicht nötig war
     oder vergessen wurde.)
     Sie sehen jetzt ein schwarzes Fenster „MC4Y-Suite - Installer“. Lassen Sie es offen, bis alles
     fertig ist. Nach wenigen Sekunden öffnet sich Ihr Browser mit der Seite „Was möchten Sie einrichten?“.
     Öffnet sich kein Browser: Im schwarzen Fenster steht unter „Oeffnet sich kein Browser“ eine lange
     Adresse. Markieren Sie sie mit der Maus, kopieren Sie sie (Strg + C oder rechte Maustaste) und fügen
     Sie sie in die Adresszeile Ihres Browsers ein (Strg + V, dann Eingabetaste).

Teil 3: Im Installer (sechs Schritte, oben als Leiste zu sehen)
 11. Klicken Sie auf „Die Suite auf diesem Windows-Rechner“ und dann unten rechts auf „Weiter →“.
     (Für Weg A klicken Sie hier stattdessen auf „Nur im Browser (am einfachsten)“.)
 12. Schritt „Neu oder aktualisieren“: Sie sehen „Keine vorhandene Installation gefunden – es wird neu
     installiert“. Klicken Sie auf „Weiter →“.
     (Ist die Suite schon installiert, steht hier „Vorhandene Installation gefunden“ – siehe Abschnitt 10.)
 13. Schritt „Speicherorte“: Klicken Sie neben „Alle Orte auf“ auf ein Laufwerk – haben Sie nur eines,
     auf „Laufwerk C“.
     Sie sehen jetzt in den vier Feldern Programm, PHP, Datenablage und Sicherungen fertige Ordner und
     darunter grüne Hinweise wie „in Ordnung – wird angelegt“.
     Haben Sie ein zweites Laufwerk (D: oder E:), ist es gut, dort die Sicherungen abzulegen: Klicken Sie
     unter „Tägliche Sicherungen“ auf das andere Laufwerk.
 14. Klicken Sie auf „Weiter →“.
 15. Schritt „Werkzeuge“: Lassen Sie alles ausgewählt und klicken Sie auf „Weiter →“.
 16. Schritt „Voraussetzungen“: Der Installer prüft einen Moment lang Ihren Rechner.
     Sie sehen jetzt eine Tabelle. „⬇ wird installiert“ heißt: Das lädt der Installer zusätzlich herunter
     (zum Beispiel PHP von windows.php.net oder Python für die Taskleiste) – mit Angabe der Quelle.
 17. Setzen Sie das Häkchen bei „Ich bin einverstanden, dass diese Voraussetzungen heruntergeladen und
     installiert werden“.
 18. Klicken Sie auf „Installieren“.
 19. Windows fragt: „Möchten Sie zulassen, dass durch diese App Änderungen an Ihrem Gerät vorgenommen
     werden?“ (App: Windows PowerShell). Klicken Sie auf „Ja“.
     Ist Ihr Konto kein Administrator, fragt Windows hier nach Name und Kennwort eines Administrators.
 20. Warten Sie. Sie sehen eine Liste von Arbeitsschritten, die nacheinander ein Häkchen ✓ bekommen.
     Das dauert meist 2 bis 10 Minuten.
 21. Sie sehen jetzt „Fertig installiert.“ und die Adresse http://127.0.0.1:8090/.
     Klicken Sie auf „Suite öffnen“ und machen Sie mit Abschnitt 7 weiter.
 22. Wechseln Sie danach zurück zum Installer und klicken Sie auf „Installer beenden“.
     Das schwarze Fenster schließt sich.

Die Suite startet ab jetzt bei jedem Hochfahren von selbst. Sie erreichen sie nur auf diesem Rechner,
unter der Adresse http://127.0.0.1:8090/ (am besten als Lesezeichen speichern). Die Installation legt
außerdem eine Verknüpfung „MC4Y-Produktivitaetssuite“ auf den Desktop und ins Startmenü (lief die
Installation auf Englisch: „MC4Y Productivity Suite“).


5. Weg C – Die Suite auf diesem Mac
-----------------------------------
Sie brauchen die Datei „mc4y-suite.zip“, macOS 12 oder neuer und das Kennwort Ihres Mac-Kontos
(Abschnitt 2). Homebrew brauchen Sie nicht: Die Installation lädt ihr eigenes PHP selbst herunter und
prüft es mit einer fest eingetragenen Prüfsumme.

Auf dem Mac geht das am sichersten mit dem „Terminal“. Das ist ein Fenster, in das man Befehle tippt.
Keine Sorge: Sie geben nur zwei Befehle ein, die Sie hier abschreiben oder kopieren können.
Das Installationsskript schreibt Deutsch oder Englisch – wie Ihr Mac eingestellt ist. Ist Ihr Mac auf
Englisch eingestellt und möchten Sie die hier zitierten deutschen Texte sehen, hängen Sie an den Befehl ein
Leerzeichen und --lang de an (Englisch erzwingt --lang en).
  - Einen Befehl kopieren: in dieser Anleitung mit der Maus markieren und cmd + C drücken.
  - Einfügen: ins Terminal-Fenster klicken und cmd + V drücken.
  - Ein Befehl wird erst ausgeführt, wenn Sie die Eingabetaste (⏎, auch „Return“) drücken.
  - Fragt das Terminal nach einem Kennwort, sehen Sie beim Tippen keine Zeichen, nicht einmal Sternchen.
    Das ist so gewollt. Tippen Sie einfach weiter und drücken Sie am Ende die Eingabetaste.

Teil 1: Paket herunterladen und auspacken
  1. Laden Sie „mc4y-suite.zip“ herunter.
  2. Öffnen Sie den Finder (das blau-weiße Gesicht im Dock) und klicken Sie links auf „Downloads“.
  3. Sehen Sie dort „mc4y-suite.zip“, doppelklicken Sie darauf.
     Sie sehen jetzt einen Ordner „MC4Y-Suite-0.4.15“.
     (Safari packt die Datei oft schon selbst aus – dann ist der Ordner bereits da. Das ist in Ordnung.)
     Lassen Sie dieses Finder-Fenster offen.

Teil 2: Das Terminal öffnen
  4. Drücken Sie cmd + Leertaste.
     Sie sehen jetzt das Suchfeld „Spotlight“ in der Bildschirmmitte.
  5. Tippen Sie „Terminal“ und drücken Sie die Eingabetaste.
     Sie sehen jetzt ein Fenster mit einer Zeile wie „anna@MacBook-Pro ~ %“ und einem blinkenden Strich.
     (Ohne Spotlight: Finder › „Programme“ › „Dienstprogramme“ › „Terminal“.)

Teil 3: In den Paket-Ordner wechseln
  6. Tippen Sie im Terminal die zwei Buchstaben cd und danach ein Leerzeichen. Drücken Sie noch NICHT
     die Eingabetaste.
  7. Ziehen Sie den Ordner „MC4Y-Suite-0.4.15“ aus dem Finder-Fenster mit der Maus in das
     Terminal-Fenster und lassen Sie ihn dort los.
     Sie sehen jetzt hinter „cd “ den Weg zu dem Ordner, zum Beispiel:
       cd /Users/anna/Downloads/MC4Y-Suite-0.4.15
  8. Drücken Sie die Eingabetaste.
     Fragt macOS, ob „Terminal“ auf Dateien im Ordner „Downloads“ zugreifen darf, klicken Sie auf „OK“.

Teil 4: Installieren
  9. Kopieren Sie diesen Befehl, fügen Sie ihn ins Terminal ein und drücken Sie die Eingabetaste:

       bash install/macos/installieren.command

     Sie sehen jetzt „Die Installation braucht Administratorrechte …“ und darunter „Password:“.
 10. Tippen Sie das Kennwort, mit dem Sie sich am Mac anmelden, und drücken Sie die Eingabetaste.
     (Beim Tippen erscheinen keine Zeichen.) Steht danach „Sorry, try again.“, war das Kennwort falsch –
     tippen Sie es noch einmal.
     Sie sehen jetzt einige Angaben zu Ihrem Mac, zum Beispiel
       PHP:          eigenes PHP 8.4.23 für Intel-Mac – wird während der Installation heruntergeladen
     und darunter die Frage nach dem Datenordner.
 11. Bei „Datenordner [/Library/Application Support/MC4Y-Suite-Daten]:“ drücken Sie einfach die
     Eingabetaste. Damit übernehmen Sie den Vorschlag in den eckigen Klammern.
     Sie sehen jetzt eine „Zusammenfassung“ und die Frage „Desktop-Taskleiste für … gleich mit einrichten?“.
 12. Drücken Sie die Eingabetaste (das bedeutet „ja“). Die Desktop-Taskleiste hält die Werkzeuge immer
     griffbereit, auch ohne offenen Browser (Abschnitt 12). Sie braucht Python; fehlt es, läuft die Suite
     trotzdem, und das Skript erklärt, wie Sie die Taskleiste nachholen.
 13. Bei „Soll die Taskleiste beim Anmelden am Mac automatisch starten?“ drücken Sie die Eingabetaste („ja“)
     – oder tippen n, wenn Sie sie lieber selbst starten.
     Sie sehen jetzt die Frage „Installation jetzt ausführen?“.
 14. Drücken Sie die Eingabetaste (das bedeutet „ja“).
 15. Warten Sie. Zeile für Zeile erscheinen die Arbeitsschritte, zuerst das Herunterladen von PHP.
     Das dauert meist 1 bis 5 Minuten.
 16. Sie sehen jetzt „Fertig. Adresse: http://127.0.0.1:8090/“. Ihr Browser öffnet sich mit der Seite
     „Suite einrichten“. Machen Sie mit Abschnitt 7 weiter.
 17. Danach die Taskleiste starten: cmd + Leertaste, „MC4Y“ tippen, „MC4Y Taskleiste“ wählen, Eingabetaste.
     Melden Sie sie mit demselben Anmeldenamen und Kennwort an wie im Browser.
 18. Gehen Sie zurück ins Terminal. Dort steht „Eingabetaste zum Schließen …“. Drücken Sie die
     Eingabetaste und schließen Sie das Terminal mit cmd + Q. Suite und Taskleiste laufen weiter.

Die Suite startet ab jetzt bei jedem Hochfahren von selbst. Sie erreichen sie nur auf diesem Mac, unter
der Adresse http://127.0.0.1:8090/.

So starten Sie die Suite und die Taskleiste später
  Die Installation legt zwei Programme mit Symbol an: „MC4Y-Suite“ (öffnet die Suite im Browser) und
  „MC4Y Taskleiste“. Sie finden beide im Launchpad (im Dock das Symbol mit den bunten Kacheln; unter
  macOS 26 heißt es „Apps“), über Spotlight (cmd + Leertaste, „MC4Y“ tippen, Eingabetaste) und im Finder
  unter „Programme“. Tipp: die Symbole ins Dock ziehen.
  Wichtig: Die Taskleiste, die Sie in der Suite unter „Ihr Konto“ › „Darstellung“ einschalten können, gehört
  zum Browserfenster und verschwindet mit ihm. Die Desktop-Taskleiste „MC4Y Taskleiste“ bleibt offen.
  Den Start beim Anmelden schalten Sie in der Taskleiste ein oder aus: auf 🔍 klicken, unten „Einstellungen“
  › Häkchen „Beim Anmelden am Rechner starten“ › „Speichern“ (ab macOS 13 auch unter Systemeinstellungen ›
  Allgemein › Anmeldeobjekte, Bereich „Im Hintergrund erlauben“).

Für Fachleute: der grafische Installer
  Für die meisten ist der Weg oben (bash installieren.command) der einfachste – er braucht kein Python und
  keinen zusätzlichen Schritt. Der grafische Installer ist auf dem Mac eher für Fachleute: Er läuft ebenfalls
  nur über das Terminal und braucht zusätzlich Python.
  Der grafische Installer braucht auf dem Mac Python. Ist es nicht da, installieren Sie es von
  https://www.python.org/downloads/macos/ („macOS 64-bit universal2 installer“, im Ordner „Downloads“ die
  .pkg-Datei doppelklicken und den Schritten folgen). Danach machen Sie die Schritte 1 bis 8 wie oben und
  geben statt Schritt 9 ein:  bash installer-starten.command
  Im Browser wählen Sie „Die Suite auf diesem Mac“ und folgen den Schritten wie in Abschnitt 4 (Teil 3);
  macOS fragt beim Installieren in einem eigenen Fenster nach Ihrem Kennwort.
  Bitte starten Sie die Dateien des Pakets nicht per Doppelklick im Finder: macOS blockiert das bei
  Dateien aus dem Internet. Über das Terminal mit „bash …“ gibt es dieses Problem nicht.


6. Weg D – Server im Firmennetz (für die Person, die den Server betreut)
------------------------------------------------------------------------
6.1 Windows Server (empfohlen, Windows Server 2019 oder neuer)
  Am einfachsten wie Weg B mit dem grafischen Installer: auf dem Server die Teile 1 und 2 aus Abschnitt 4,
  dann „Windows Server für ein Team“ wählen. Der Installer richtet IIS (den Webserver von Windows), PHP,
  HTTPS mit einem eigenen Zertifikat, die Firewall-Regel und die tägliche Sicherung ein. Er geht auch per
  Fernwartung von Ihrem Arbeitsplatz aus („Auf einem anderen Server (Fernwartung)“) – Windows fragt dann in
  einem eigenen Fenster nach einem Administratorkonto des Servers.
  Am Ende zeigt der Installer einen Einrichtungscode; Sie brauchen ihn in Abschnitt 7.
  Danach:
    1. Das Zertifikat auf den Arbeitsplätzen als vertrauenswürdig eintragen (z. B. per Gruppenrichtlinie).
       Die Datei liegt unter https://<Servername>/zertifikat/mc4y-suite.cer.
    2. https://<Servername>/ öffnen und das erste Konto anlegen (Abschnitt 7, mit Einrichtungscode).
    3. In der Suite unter „Verwaltung“ › „Anmeldung“ auf Wunsch die Anmeldung mit dem Windows-Konto
       einschalten.
    4. Unter „Verwaltung“ › „Sicherung“ auf „Jetzt sichern“ und danach in der neuen Zeile auf „Prüfen“
       klicken.
  Einzelheiten: public/handbuch.html (Handbuch für den Betrieb, im Browser öffnen).

6.2 Webhosting-Paket (ohne eigenen Server)
  1. Im Kundenmenü Ihres Anbieters PHP 8.2 oder neuer einstellen.
  2. Die Ordner „app“, „public“ und „install“ sowie die Dateien „.htaccess“ und „konfig.beispiel.php“ per
     SFTP hochladen – auch die versteckten Dateien („.htaccess“, „public/.user.ini“). Am besten zeigt die
     Domain auf den Ordner „public“.
  3. Die Adresse aufrufen. Die Suite zeigt „Ablage einrichten“. Den Code aus der Datei
     „ablage-einrichtungscode.txt“ (per SFTP lesen) eingeben und einen Datenordner AUSSERHALB des
     Webverzeichnisses wählen.
  4. Das erste Konto anlegen (Abschnitt 7; der Code steht in <Datenordner>/system/einrichtungscode.txt).
  5. Für die tägliche Sicherung einen Cronjob anlegen:  php /pfad/zu/app/cli.php sicherung --auto
  Für personenbezogene Daten einen Vertrag zur Auftragsverarbeitung mit dem Anbieter schließen.

6.3 Linux
  Siehe install/linux/LIESMICH.txt. Kurz, im entpackten Paket:
    sudo bash install/linux/installieren.sh --probelauf     zeigt nur, was geschähe
    sudo bash install/linux/installieren.sh                 Server mit Apache und HTTPS
    sudo bash install/linux/installieren.sh --einzelplatz   nur dieser Rechner, http://127.0.0.1:8090/
  Die Linux-Skripte sind noch nicht auf echten Systemen erprobt: zuerst mit --probelauf ansehen.


7. Das erste Konto anlegen
--------------------------
Nach der Installation zeigt der Browser die Seite „Suite einrichten“. Das erste Konto wird Administrator:
Es verwaltet Benutzer, Gruppen und Kategorien.
  1. Tragen Sie bei „Organisation“ den Namen Ihrer Firma oder Praxis ein (kann leer bleiben).
  2. Tragen Sie bei „Ihr Name“ Ihren Namen ein.
  3. Tragen Sie bei „Anmeldename“ einen Namen ohne Leerzeichen ein, zum Beispiel „anna.muster“.
  4. Tragen Sie bei „Kennwort“ ein Kennwort mit mindestens 10 Zeichen ein und wiederholen Sie es darunter.
     Schreiben Sie es sich auf und bewahren Sie es sicher auf.
  5. Nur auf einem Server: Tragen Sie bei „Einrichtungscode“ den Code ein, den der Installer am Ende
     gezeigt hat.
  6. Lassen Sie das Häkchen „Mich zusätzlich in die Gruppe „Alle Werkzeuge – Vollzugriff“ aufnehmen“
     gesetzt.
  7. Klicken Sie auf „Einrichten und anmelden“.
     Sie sehen jetzt die Startseite der Suite mit Ihren Werkzeugen und Modulen.


8. So prüfen Sie, ob es geklappt hat
------------------------------------
Weg A
  - „index.html“ zeigt die Seite „MC4Y-Werkzeuge“ mit allen Werkzeugen.
  - Öffnen Sie ein Werkzeug, klicken Sie auf „Speichern“ und danach auf „Öffnen“: Ihre Datei kommt wieder.

Wege B und C
  1. Öffnen Sie im Browser die Adresse http://127.0.0.1:8090/ .
     Sie sehen jetzt die Anmeldeseite der Suite (bzw. die Startseite, wenn Sie noch angemeldet sind).
  2. Starten Sie den Rechner neu und öffnen Sie die Adresse noch einmal.
     Sie sehen jetzt wieder die Anmeldeseite – die Suite startet also von selbst.
  3. Klicken Sie in der Suite auf „Verwaltung“ und dann auf „Systemprüfung“.
     Die meisten Zeilen sind grün. Gelbe Zeilen sind Empfehlungen, rote Zeilen sollten Sie beheben.
  4. Klicken Sie unter „Verwaltung“ auf „Sicherung“ und dann auf „Jetzt sichern“.
     Sie sehen jetzt „Gesichert: …“ und in der Tabelle eine neue Zeile mit dem Anlass „von Hand“.
  5. Klicken Sie in dieser Zeile auf „Prüfen“.
     Unter der Tabelle erscheint das Ergebnis der Prüfung.

Weg D
  Wie bei B und C, aber mit der Adresse https://<Servername>/ – und zusätzlich von einem Arbeitsplatz aus.


9. Häufige Probleme
-------------------
Windows
  - Blaues Fenster „Der Computer wurde durch Windows geschützt“: „Weitere Informationen“ › „Trotzdem
    ausführen“. Künftig vorher Schritt 5 in Abschnitt 4 („Zulassen“) machen.
  - Das schwarze Fenster schließt sich sofort wieder: Das Paket ist nicht ausgepackt. Bitte die Schritte 7
    und 8 in Abschnitt 4 machen und „Installer-starten“ im ausgepackten Ordner starten – nicht in der
    ZIP-Datei.
  - Im Schritt „Speicherorte“ bleibt „Weiter →“ grau: Unter einem der Felder steht ein roter Hinweis. Lesen
    Sie ihn und wählen Sie einen anderen Ordner bzw. ein anderes Laufwerk.
  - „Port 8090 … ist belegt“: Ein anderes Programm nutzt diese Nummer. Tragen Sie im Schritt „Speicherorte“
    bei „Port“ zum Beispiel 8091 ein. Die Adresse lautet dann http://127.0.0.1:8091/.
  - Sie kennen kein Administratorkennwort: Fragen Sie die Person, die den Rechner eingerichtet hat – oder
    nehmen Sie Weg A, der braucht keins.

Mac
  - „No such file or directory“ oder „command not found“: Sie sind nicht im Paket-Ordner. Wiederholen Sie die
    Schritte 6 bis 8 in Abschnitt 5 (cd, Leerzeichen, Ordner ins Terminal ziehen, Eingabetaste).
  - „Sorry, try again.“: Das Kennwort war falsch. Tippen Sie es langsam noch einmal (Groß-/Kleinschreibung,
    Feststelltaste).
  - „… is not in the sudoers file“: Ihr Mac-Konto ist kein Administrator. Melden Sie sich mit einem
    Administratorkonto an – oder nehmen Sie Weg A.
  - „Operation not permitted“: Das Terminal darf den Ordner „Downloads“ nicht lesen. Öffnen Sie im
    Apple-Menü „Systemeinstellungen“ › „Datenschutz & Sicherheit“ › „Dateien und Ordner“, klappen Sie
    „Terminal“ auf und schalten Sie „Ordner „Downloads““ ein. Danach Schritt 9 wiederholen.
  - „Dieser Mac hat macOS 11… Die Suite braucht macOS 12 (Monterey) oder neuer“: Aktualisieren Sie macOS
    (Abschnitt 2) – oder nehmen Sie Weg A.
  - „PHP ließ sich nicht herunterladen“: Prüfen Sie die Internetverbindung und starten Sie Schritt 9 noch
    einmal. Ohne Internet: Die Meldung nennt eine Datei und eine Adresse. Laden Sie die Datei auf einem
    anderen Rechner und legen Sie sie in einen Ordner „voraussetzungen“ im Paket-Ordner.
  - Beim Doppelklick auf eine Datei des Pakets meldet macOS „… kann nicht geöffnet werden“ oder „Apple
    konnte nicht überprüfen …“: Starten Sie die Dateien des Pakets nicht per Doppelklick, sondern wie in
    Abschnitt 5 beschrieben im Terminal mit „bash …“.
  - „Für die Taskleiste fehlt Python …“: Die Suite läuft trotzdem. Python von
    https://www.python.org/downloads/macos/ installieren („macOS 64-bit universal2 installer“), dann wie in
    Abschnitt 10 (Weg C) aktualisieren, aber mit:  bash install/macos/installieren.command --aktualisieren --taskleiste
  - Die Taskleiste verschwindet, wenn Sie den Browser schließen: Das ist die Taskleiste im Browser. Starten
    Sie das Programm „MC4Y Taskleiste“ (Abschnitt 5, „So starten Sie … später“).

Alle
  - Die Adresse http://127.0.0.1:8090/ zeigt „Die Website ist nicht erreichbar“: Warten Sie eine Minute
    und laden Sie die Seite neu. Hilft das nicht, starten Sie den Rechner neu. Hilft auch das nicht, schicken
    Sie bitte das Installationsprotokoll an den Support. Es liegt im Programmordner und heißt
    „installation_<Datum>.log“ (Windows: C:\Program Files\MC4Y-Suite bzw. der gewählte Ordner; Mac:
    /Library/Application Support/MC4Y-Suite).
  - Kennwort vergessen (auch das des einzigen Administratorkontos): Klicken Sie auf der Anmeldeseite auf
    „Kennwort vergessen?“. Den dort verlangten Rücksetzcode erzeugt die Person, die den Rechner mit der Suite
    betreut – auf einem Einzelplatz sind das Sie selbst:
      Windows: Im Explorer den Ordner C:\Program Files\MC4Y-Suite\install\windows öffnen (bzw. den gewählten
               Programmordner) und „Kennwort-zuruecksetzen.bat“ doppelklicken; die Windows-Rückfrage mit „Ja“
               bestätigen.
      Mac:     Im Terminal eingeben:
               bash "/Library/Application Support/MC4Y-Suite/install/macos/kennwort-zuruecksetzen.command"
      Linux:   sudo bash /opt/mc4y-suite/install/linux/kennwort-zuruecksetzen.sh
    Tippen Sie den Anmeldenamen ein. Sie sehen jetzt einen Code wie K7PX-QM4R-TV9H (30 Minuten gültig, nur
    einmal verwendbar). Tragen Sie im Browser Anmeldenamen, Code und ein neues Kennwort ein. Für Konten mit
    Windows-Anmeldung (Domäne) gibt es keinen Code – das Kennwort wird an Windows geändert.


10. Aktualisieren
-----------------
Beim Aktualisieren bleiben alle Ihre Inhalte, Konten und Einstellungen erhalten. Die Installation sichert
die Datenbank vorher selbst.

Weg A
  1. Laden Sie die neue „mc4y-werkzeuge.zip“ herunter und packen Sie sie aus (wie in Abschnitt 3).
  2. Öffnen Sie den neuen Ordner, markieren Sie alles (Windows: Strg + A, Mac: cmd + A) und kopieren Sie es
     (Strg + C bzw. cmd + C).
  3. Öffnen Sie Ihren bisherigen Werkzeug-Ordner und fügen Sie ein (Strg + V bzw. cmd + V).
  4. Fragt der Rechner, ob vorhandene Dateien ersetzt werden sollen: „Dateien im Ziel ersetzen“ (Windows)
     bzw. „Ersetzen“ (Mac).
  Ihre gespeicherten Arbeiten liegen woanders und bleiben unberührt.

Weg B (Windows)
  Laden Sie das neue „mc4y-suite.zip“ und machen Sie Abschnitt 4 noch einmal (Teile 1 bis 3). Im Schritt
  „Neu oder aktualisieren“ steht jetzt „Vorhandene Installation gefunden“ und „Aktualisieren“ ist gewählt.
  Klicken Sie einfach weiter.

Weg C (Mac)
  Laden Sie das neue „mc4y-suite.zip“ und machen Sie Abschnitt 5 noch einmal (Schritte 1 bis 8). Statt des
  Befehls in Schritt 9 geben Sie ein:

       bash install/macos/installieren.command --aktualisieren

  Danach Kennwort tippen. Fehlt die Desktop-Taskleiste noch, fragt das Skript, ob sie mit eingerichtet werden
  soll (Eingabetaste = ja); ist sie schon da, ob sie mit aktualisiert werden soll. Dann „Aktualisierung jetzt
  ausführen?“ mit der Eingabetaste bestätigen. Das Programm „MC4Y-Suite“ im Ordner „Programme“ legt die
  Aktualisierung an bzw. erneuert es – auch bei älteren Installationen, die es noch nicht hatten.

Weg D
  Wie bei der Installation; der Installer erkennt die vorhandene Installation. Befehle für Fachleute:
  Abschnitt 13.


11. Entfernen (deinstallieren)
------------------------------
Ihre Inhalte (der Datenordner) bleiben dabei erhalten – außer Sie löschen sie ausdrücklich.

Weg A
  Ziehen Sie den Werkzeug-Ordner in den Papierkorb. Ihre gespeicherten Dateien bleiben.

Weg B (Windows)
  1. Öffnen Sie das ausgepackte Paket (Abschnitt 4, Teil 1) und darin den Ordner „install“ und dann
     „windows“. (Haben Sie das Paket nicht mehr: Im Programmordner der Suite, zum Beispiel
     C:\Program Files\MC4Y-Suite, liegt derselbe Ordner.)
  2. Doppelklicken Sie auf „deinstallieren“.
  3. Windows fragt nach Administratorrechten: „Ja“.
  4. Bei „Suite deinstallieren? (j/n)“ tippen Sie j und drücken die Eingabetaste.
  5. Bei „Enter druecken zum Schliessen“ drücken Sie die Eingabetaste.
  Ihre Inhalte liegen danach weiter im Datenordner (zum Beispiel C:\ProgramData\MC4Y-Suite-Daten). Möchten
  Sie auch sie löschen, löschen Sie diesen Ordner danach selbst.

Weg C (Mac)
  1. Öffnen Sie das Terminal (Abschnitt 5, Schritte 4 und 5).
  2. Kopieren Sie diesen Befehl, fügen Sie ihn ein und drücken Sie die Eingabetaste:

       bash "/Library/Application Support/MC4Y-Suite/install/macos/deinstallieren.command"

  3. Kennwort tippen, Eingabetaste.
  4. Bei „Die MC4Y-Produktivitätssuite deinstallieren? [j/N]“ tippen Sie j und drücken die Eingabetaste.
  Entfernt werden die Suite, das Programm „MC4Y-Suite“, ihr eigenes PHP und das versteckte Systemkonto. Ihre
  Inhalte bleiben in /Library/Application Support/MC4Y-Suite-Daten. Sollen auch sie weg, hängen Sie an den
  Befehl in Schritt 2 ein Leerzeichen und --daten-loeschen an und tippen später auf Nachfrage LOESCHEN.
  Die Desktop-Taskleiste gehört zu Ihrem Benutzerkonto und bleibt. Entfernen (ohne Kennwort):
       bash ~/"Library/Application Support/MC4Y/Taskleiste/deinstallieren-macos.command"


12. Die Desktop-Taskleiste
--------------------------
Die Taskleiste ist eine kleine Leiste am Bildschirmrand, mit der Sie die Werkzeuge der Suite mit einem
Klick öffnen – auch ohne offenen Browser. Sie ist freiwillig.
  - Unter Windows richtet der grafische Installer sie gleich mit ein (Schritt „Werkzeuge“, Eintrag
    „Desktop-Taskleiste“). Auf dem Mac bietet das Installationsskript der Suite sie an (Abschnitt 5,
    Schritte 12 und 13).
  - Danach finden Sie sie als „MC4Y Taskleiste“ im Startmenü (Windows), im Launchpad bzw. über Spotlight
    (Mac) oder im Anwendungsmenü (Linux). Auf Wunsch startet sie beim Anmelden von selbst.
  - Nicht verwechseln: Die Taskleiste in der Suite unter „Ihr Konto“ › „Darstellung“ lebt im Browserfenster
    und schließt sich mit ihm; die Desktop-Taskleiste ist ein eigenes Programm und bleibt offen.
  - Sonst laden Sie sie in der Suite herunter: Klicken Sie oben auf Ihren Namen (Seite „Ihr Konto“) und
    dort im Abschnitt „Desktop-Taskleiste und App“ auf den Download. So heruntergeladen kennt sie die
    Adresse Ihrer Suite schon.
  - Die Schritt-für-Schritt-Anleitung liegt in der Datei „LIESMICH.txt“ im Paket mc4y-taskleiste.zip.
    Die Taskleiste und ihr Installationsskript sprechen Deutsch oder Englisch – wie Ihr System; in der
    Taskleiste schalten Sie mit „DE | EN“ um.


13. Für Fachleute: Befehle und Optionen
---------------------------------------
Alle Skripte liegen im Paket unter install/ und nach der Installation im Programmordner. Jedes kennt einen
Probelauf, der nichts verändert. Sie schreiben Deutsch oder Englisch – wie Ihr Rechner eingestellt ist; zur
Wahl hängen Sie -Sprache de bzw. -Sprache en (Windows) oder --lang de bzw. --lang en (Mac, Linux) an. Die
Kommandozeile der Suite (app/cli.php) schreibt Deutsch, mit --lang en Englisch. Ausführlich:
public/handbuch.html.

Windows Einzelplatz (ohne grafischen Installer; Eingabeaufforderung im Paket, als normaler Benutzer –
Windows fragt nach Administratorrechten):
  install\windows\installieren.bat -Probelauf
  install\windows\installieren.bat -PhpZip <php-8.x.y-nts-Win32-vs17-x64.zip> -PhpSha256 <Prüfsumme>
      ohne Fragen: -Programm E:\MC4Y-Suite -Daten E:\MC4Y-Suite-Daten -SicherungOrdner F:\MC4Y-Suite-Sicherungen
  Das PHP-Paket gibt es unter https://windows.php.net/download/ („VS17 x64 Non Thread Safe“, Prüfsumme
  daneben). Startet PHP nicht, fehlt die Visual-C++-Laufzeit von Microsoft (vc_redist.x64.exe).

Windows Server mit IIS:
  install\windows\installieren-server.bat -PhpZip … -PhpSha256 … -VcRedist C:\Pakete\vc_redist.x64.exe
  vom Arbeitsplatz aus (WinRM, Kerberos; Anmeldung im Windows-Dialog):
  powershell -ExecutionPolicy Bypass -File install\windows\auf-server-installieren.ps1 -Server server.firma.local -PhpZip … -PhpSha256 … -VcRedist …

macOS:
  bash install/macos/installieren.command --probelauf
  bash install/macos/installieren.command [--daten <Ordner>] [--port <Nr>] [--still --ja]
  bash install/macos/installieren.command --php-quelle homebrew     PHP aus Homebrew statt des eigenen PHP
  … --taskleiste | --ohne-taskleiste [--ohne-autostart]            Desktop-Taskleiste ohne Rückfrage bzw. nicht
  bash install/macos/installieren.command --hilfe                   alle Angaben
  Das eigene PHP: PHP 8.4 von static-php-cli (https://static-php.dev, Satz „common“), Prüfsumme im Skript,
  unter /Library/Application Support/MC4Y-Suite-PHP, ab macOS 12 (Intel und Apple-Chip). Ohne Internet:
  die im Fehlerfall genannte Datei in „voraussetzungen“ im Paket legen. Einzelheiten: install/macos/LIESMICH.txt.

Linux: install/linux/LIESMICH.txt.

Aktualisieren (immer aus dem NEUEN, entpackten Paket; die Datenbank wird vorher gesichert):
  Windows Einzelplatz:  installieren.bat -Aktualisieren [-DatenNeu E:\MC4Y-Suite-Daten] [-SicherungenNeu F:\…]
  Windows Server:       installieren-server.bat -Aktualisieren   (bzw. auf-server-installieren.ps1 -Server … -Aktualisieren)
  Linux:                sudo bash install/linux/installieren.sh --aktualisieren
  macOS:                bash install/macos/installieren.command --aktualisieren [--php-quelle eigen|homebrew]
  Webhosting:           app, public und install ersetzen (konfig.php und Datenordner bleiben stehen)
Die Orte der Installation (Programm, PHP, Datenablage, Sicherungen, Port) übernehmen die Skripte aus der
bestehenden Installation – auch wenn sie nicht auf C: liegt.

Datenablage oder Sicherungen verschieben:
  Windows: install\windows\datenordner-verschieben.ps1 -Ziel E:\MC4Y-Suite-Daten [-Sicherungen F:\MC4Y-Suite-Sicherungen]
  Linux:   sudo bash install/linux/datenordner-verschieben.sh <neuer Ordner>
  macOS:   von Hand, siehe install/macos/LIESMICH.txt
Die bisherigen Ordner bleiben liegen, bis Sie sie nach einer Prüfung selbst löschen.

Deinstallieren:
  Windows:  install\windows\deinstallieren.bat bzw. deinstallieren-server.bat (Datenordner bleibt; -DatenLoeschen)
  Linux:    sudo bash /opt/mc4y-suite/install/linux/deinstallieren.sh [--daten-loeschen]
  macOS:    bash "/Library/Application Support/MC4Y-Suite/install/macos/deinstallieren.command" [--daten-loeschen]

Voraussetzungen der Suite: PHP ab 8.2 (empfohlen 8.4) mit pdo_sqlite, mbstring, openssl, fileinfo und zip;
sodium und opcache empfohlen; für die Anmeldung über Active Directory ldap. Keine Datenbank-Software nötig
(SQLite ist in PHP enthalten). Nicht aus einem Nextcloud- oder anderen Cloud-Ordner starten – dabei gehen
Ausführungsrechte und versteckte Dateien wie .htaccess verloren.


Haftung und Datenschutz
-----------------------
Die Suite wird unentgeltlich und ohne jede Gewährleistung bereitgestellt (siehe LIZENZ.txt). Wer sie
installiert, betreibt sie selbst und ist für die darin gespeicherten Daten verantwortlich. Die Suite
überträgt keine Daten an MY COACHING FOR YOU. Bitte prüfen Sie die tägliche Sicherung regelmäßig und
kopieren Sie Sicherungen ab und zu auf einen anderen Datenträger.

Die Einzelplatz-Installation auf dem Mac ist auf einem echten Gerät erprobt (Oktober 2026). Der
Server-Betrieb unter macOS und die Linux-Skripte sind nach Dokumentation geschrieben, aber noch nicht auf
echten Geräten erprobt. Über Rückmeldungen freue ich mich.
