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

Installationen sind Stand April 2026 ab macOS 14 Sonoma möglich.

Siehe macOS Requirements

Die Firma untermStrich software gmbh übernimmt keine Haftung für etwaige Schäden oder Fehler die direkt oder indirekt durch die Benutzung oder nicht Benutzung dieser Anleitung entstehen!

Apache, PHP, MySQL muss wie auch untermStrich aktuell gehalten werden. Dies gilt besonders, wenn der Server im Internet verfügbar sein soll.

ⓘ Update von macOS

Informationen zum Update von macOS (Von 10.13 auf 10.15 etwa)

Führen Sie unbedingt vor dem Update von macOS das Update auf X3 oder gleich X4 durch!

ⓘ Update von MySQL

Das Update von MySQL auf macOS ist nur manuell durchführbar.

MySQL übernimmt auf macOS nicht automatisch die alte Datenbank, bei einem Update.

Erstellen Sie unbedingt ein Backup (SQL-Dump) der Datenbank, bevor Sie mit dem Update beginnen. Per MySQL Workbench - Import/Export.

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

Stellen Sie sicher, dass der Launch Daemon deaktiviert ist, bevor Sie MySQL deinstallieren.
sudo launchctl unload -F com.oracle.oss.mysql.mysqld.plist

Die alte MySQL Version muss vor der Installation der neuen Version deinstalliert werden.
Dafür gibt es kein Deinstallationsprogramm.
Pfade zur Deinstallation: MySQL Spezialthemen

Sie müssen die Datenbank manuell vom alten Verzeichnis in das das neue Verzeichnis umkopieren.

ⓘ Virenscanner

Installieren Sie keine (zusätzlichen) Virenscanner auf ihrem Server.

X. Vorbereitung

Laden Sie sich einen kostenlosen Editor. (Beispiel: BBEdit free/TextWrangler von Bare Bones Software)
So öffnen Sie ein verstecktes Verzeichnis:
- Gehen Sie in den Finder und wählen Sie im Menü „Gehe zu“ > „Gehe zu Ordner“:

I. MySQL

MySQL Workbench

Installieren Sie die MySQL Workbench.

MySQL Server

MySQL Server 8.0 herunterladen:
- Ab MySQL 8.0.22.
- https://dev.mysql.com/downloads/mysql/8.0.html ¹⁾
- Laden Sie die DMG Datei herunter.
Installieren Sie das Paket
Verwenden Sie auf jeden Fall die Legacy Password Encryption, wenn Sie eine PHP Version vor 7.4 nutzen möchten.
Merken Sie sich das MySQL root Kennwort gut.
- Sollten Sie kein Kennwort erhalten haben: MySQL Kennwort am Mac zurücksetzen
- Melden Sie sich nach der Installation des des MySQL Servers in der grafischen Workbench an.
- Diese wird Sie nach einem neuen Kennwort fragen. Bewahren Sie dieses gut auf. Sie benötigen es, um später untermStrich zu installieren, ein Backup auszuführen u.s.w..

Konfigurieren und optimieren Sie den Server

Öffnen Sie die /etc/my.cnf (Diese Datei /etc/my.cnf muss nicht existieren. Legen Sie die Datei dann einfach an.):

MySQL 8.0

[mysqld]

Am Ende dieser Sektion einfügen:

default-authentication-plugin=mysql_native_password
 
sql-mode="STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION"
log_bin_trust_function_creators = 1
group_concat_max_len=50000
 
max_allowed_packet = 16M
table_open_cache = 512
sort_buffer_size = 2M
 
max_heap_table_size = 256M
tmp_table_size = 256M
 
innodb_buffer_pool_size=664M

Konfigurationsoptionen die nicht vorhanden sind, bitte einfach einfügen!

Setzen Sie die Rechte:
- ```
sudo chmod a+r /etc/my.cnf
```
- Geben Sie keine Schreibrechte für alle. Ansonsten wird die Datei von MySQL nicht genutzt!
MySQL neu starten
- Dies können Sie über die Systemeinstellungen durchführen:

Backup

Sie sollten regelmäßig ein Backup der MySQL Datenbank durchführen.

Informationen zum Backup
Wenn Sie manuell ein Backup erstellen möchten, können Sie auch die grafische Workbench nutzen. Im Bereich „Administration“ finden Sie „Export/Import“.
Sehr detailierte Information von Oracle (MySQL) für Systemadministratoren: Datensicherung und Wiederherstellung

II. PHP/Apache konfigurieren

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

Rechte für Verzeichnisse setzen

III. Installation von untermStrich

Folgen Sie der Installation von untermStrich

¹⁾

Es ist nicht zwingend notwendig sich auf mysql.com zu registrieren.