====== Installationsbeispiel für macOS (Als Server) für untermStrich ======

<WRAP center round important 97%>
**Installationen sind ab macOS 14 Sonoma möglich** (Stand April 2026).\\
Siehe [[https://docs.brew.sh/Installation#macos-requirements|macOS Requirements]]
</WRAP>

<WRAP center round important 97%>
  * Die Firma untermStrich software gmbh übernimmt **keine Haftung** für etwaige Schäden oder Fehler, die direkt oder indirekt durch die Benutzung oder Nichtbenutzung dieser Anleitung entstehen.
  * Apache, PHP und MySQL müssen – wie auch untermStrich – **aktuell gehalten** werden. Dies gilt besonders, wenn der Server aus dem Internet erreichbar ist.
</WRAP>

----
<WRAP center round tip 97%>
Neuinstallation oder Update?

**Neuinstallation**: Sie richten untermStrich zum ersten Mal auf diesem Mac ein → folgen Sie den Schritten I–III weiter unten.\\
**Update**: Sie haben untermStrich bereits installiert und möchten macOS oder MySQL aktualisieren → lesen Sie zuerst den Abschnitt [[de:installation:installation_macos#mysql-update|Updates & wichtige Hinweise]].


</WRAP>
===== Neuinstallation =====

==== Vorbereitung ====

  * Laden Sie einen kostenlosen Editor herunter, z. B. [[http://www.barebones.com/products/textwrangler/|BBEdit free / TextWrangler von Bare Bones Software]].
  * So öffnen Sie ein verstecktes Verzeichnis im Finder:\\ Menü **Gehe zu → Gehe zu Ordner**:
    * {{:de:installation:mac_goto.png?250|}}

:righty: Installieren Sie keine (zusätzlichen) Virenscanner auf Ihrem Server.

==== Schritt I – MySQL installieren ====

=== MySQL Workbench ===

Installieren Sie die [[http://www.mysql.de/downloads/workbench/|MySQL Workbench]].

=== MySQL Server ===

  - MySQL Server 8.0 herunterladen (ab Version 8.0.22):\\ [[https://dev.mysql.com/downloads/mysql/8.0.html]] ((Es ist nicht zwingend notwendig, sich auf mysql.com zu registrieren.))
    * :righty: Laden Sie die **DMG-Datei** herunter.
  - Paket installieren:
    * {{:de:installation:mac_mysql0.png?nolink&350|}}
  - Wählen Sie die Password Encryption
    * {{:de:installation:mac_mysql4.png?nolink&350|}}
  - Merken Sie sich das **MySQL root-Kennwort** gut.
    * Kein Kennwort bekannt? :righty: [[de:installation:reset_mysql_pw_mac|MySQL Kennwort am Mac zurücksetzen]]
    * Melden Sie sich nach der Installation in der [[http://www.mysql.de/downloads/workbench/|MySQL Workbench]] an – Sie werden nach einem neuen Kennwort gefragt. Bewahren Sie dieses sorgfältig auf (wird für Installation, Backup u. v. m. benötigt).

----

=== MySQL konfigurieren und optimieren ===

  - Öffnen Sie ''/etc/my.cnf'' (Datei muss nicht existieren – legen Sie sie ggf. neu an):
    * {{section>de:faq:mysql_optimieren#anpassungen&noheader&noindent}}
  - Rechte setzen:
    * <code bash>sudo chmod a+r /etc/my.cnf</code>
    * :!: Geben Sie **keine Schreibrechte für alle** – sonst wird die Datei von MySQL **nicht genutzt**!
  - MySQL neu starten (über die Systemeinstellungen):

<WRAP group>
<WRAP half column>
{{:de:installation:mysql_sysconfig.png?link&350|Systemeinstellungen}}
</WRAP>
<WRAP half column>
{{:de:installation:mysql_sysconfig_v8.png?350|Systemeinstellungen}}
</WRAP>
</WRAP>

----

=== Backup einrichten ===

<WRAP center round important 97%>
Führen Sie **regelmäßig** ein Backup der MySQL-Datenbank durch.
</WRAP>

  * :righty: [[de:faq:mysql_backup|Informationen zum Backup]]
  * Manuelles Backup: über die [[http://www.mysql.de/downloads/workbench/|MySQL Workbench]] unter **Administration → Export/Import**.
  * Detaillierte Informationen: [[http://dev.mysql.com/doc/refman/5.1/de/disaster-prevention.html|Datensicherung und Wiederherstellung (Oracle/MySQL)]]

==== Schritt II – PHP / Apache konfigurieren ====

:righty: Folgen Sie der passenden Anleitung für Ihr System:

  * [[de:installation:mac111_detail83|Konfiguration von macOS – ab M1 mit PHP 8.3 (Als Server)]] 
  * [[de:installation:mac111_detail81|Konfiguration von macOS – ab M1 mit PHP 8.1 (Als Server)]]
  * [[de:installation:mac14_detail81|Konfiguration von macOS – Intel mit PHP 8.1 (Als Server)]]

:righty: [[de:installation:mac_rights|Rechte für Verzeichnisse setzen]]

==== Schritt III – untermStrich installieren ====

:righty: Folgen Sie der [[de:installation:installation#i_neuinstallation_oder_update_ausfuehren|Installation von untermStrich]].

----



==== MySQL-Update ====

<WRAP center round important 97%>
Das Update von MySQL auf macOS ist nur **manuell** durchführbar – MySQL übernimmt
die alte Datenbank **nicht automatisch**.
</WRAP>

  - Erstellen Sie ein **Backup (SQL-Dump)** der Datenbank – z. B. über MySQL Workbench (Import/Export).
  - Stellen Sie sicher, dass der Launch Daemon **deaktiviert** ist:\\ ''sudo launchctl unload -F com.oracle.oss.mysql.mysqld.plist''
  - Deinstallieren Sie die alte MySQL-Version (es gibt kein Deinstallationsprogramm):\\ :righty: [[de:faq:mysql_topics#mysql_auf_mac_os_x_deinstallieren|MySQL Spezialthemen – Deinstallationspfade]]
  - Installieren Sie die neue MySQL-Version.
  - Kopieren Sie die Datenbank **manuell** vom alten in das neue Verzeichnis.

:righty: Beachten Sie die Hinweise von MySQL: [[https://dev.mysql.com/doc/refman/5.7/en/upgrading.html]]