Have any questions?
+44 1234 567 890
So bringst du Contao auf MAMP zum Laufen
(letzte Aktualisierung: 22.1.2026)
Für den Betrieb des Content Management Systems (CMS) Contao benötigst du eine Serverumgebung. So wie andere bekannte CMS verwendet auch Contao den sog. LAMP Stack, eine Software-Distribution mit den Komponenten:
- Linux (= Betriebssystem)
- Apache (= Webserver)
- MySQL (= Datenbank)
- PHP (= Scriptsprache)
Du kannst deine neue Website natürlich auch auf einem Live-System entwickeln. Bei den meisten meiner Projekte ist der Webserver aber bereits belegt; z. B. mit einer älteren Website. Und da die Entwicklung der neuen Website doch einige Tage in Anspruch nimmt, arbeite ich zunächst auf der lokalen Entwicklungsumgebung auf meinem Computer und übersiedle die neue Website erst dann, wenn sie wirklich fertig ist. Dadurch halte ich die geplante Ausfallzeit der Website kurz.
Als lokale Entwicklungsumgebung verwende ich MAMP, eine kostenlose lokale Serverumgebung, die unter macOS und Windows läuft. Hier zeige ich dir Schritt für Schritt, wie du Contao mit MAMP auf deinem Rechner zum Laufen bringst.
MAMP findest du im Web unter der Adresse https://mamp.info. Hier kannst du die Software für macOS (mind. v11) und Windows (mind. v10) kostenlos herunterladen. (Stand: 22.1.2026)
Öffne das MAMP-Installationspaket „MAMP-MAMP-PRO-7.3-Apple-chip.pkg“ (macOS) und folge der Installationsanleitung. Für die Installation muss ein Speicherplatz von 3 GB auf deinem Computer frei sein. Wenn die Installation erfolgreich war, kannst du im Anschluss daran das Installationspaket in den Papierkorb bewegen.
Du findest das Programm im Ordner Programme > MAMP > MAMP. (Anmerkung: Gemeinsam mit dem kostenlosen MAMP wird auch die kostenpflichtige Version MAMP PRO installiert. Diese kannst du aber einfach ignorieren.)
Beim Start von MAMP kannst du zwischen zwei Webservern auswählen; Apache und Nginx. Für die Verwendung mit Contao empfehle ich dir Apache.
Für die Ausführung des Contao Manager von Contao 5.x benötigst du PHP in der Version 8.1 oder höher als Scriptsprache. Und MySQL in der Version 8.0+ oder höher als Datenbank-Server. Die Informationen zu den Systemvoraussetzungen von Contao und zur PHP-Konfiguration findest du übrigens hier.
Bevor du Contao verwenden kannst, musst du noch die richtige PHP-Konfiguration einstellen. Suche die Datei php.ini deiner PHP-Version (in diesem Beispiel PHP-Version 8.3.28)! Du findest die Datei hier: Programme > MAMP > conf > php8.3.28 Öffne die Datei mit einem Texteditor; ich verwende dafür das kostenlose Programm Brackets. Du musst die folgenden drei Werte ändern:
- memory_limit auf mind. 256M (empfohlen 512M) erhöhen
- upload_max_filesize auf mind. 32M (empfohlen 64M) erhöhen
- post_max_size auf den selben Wert, wie upload_max_filesize erhöhen; also auf mind. 32M (empfohlen 64M)
Eventuell müssen noch weitere Einstellungen in der php.ini vorgenommen werden. Prüfe die Einstellungen der folgenden Konfigurationen: file_uploads, max_input_vars, opcache.enable, opcache.enable_cli, opcache.max_accelerated_files, safe_mode, open_basedir und opcache.save_comments. Die Liste mit den einzustellenden Werten findest du hier.
Für die Installation mit dem Contao-Manager muss ein neues Stammverzeichnis erstellt und ausgewählt werden. Gehe dazu in die Einstellungen von MAMP und wähle dort den Reiter "Server" aus. Hier kannst du unter Applications > MAMP > htdocs den neuen Ordner /public anlegen und als Stammverzeichnis auswählen. – Tipp: Du kannst den neuen Ordner /public auch in einen Unterordner legen, dem du einen sprechenden Namen gibst. So hältst du Ordnung zwischen verschiedenen Projekten.
So, jetzt starten wir zum ersten Mal den Server von MAMP. Öffne MAMP und klicke rechts oben auf „Start“. Der Apache Webserver startet mit PHP und MySQL, das kann beim ersten Mal ein wenig dauern. Das Start-Icon wird grün.
Wechsle in deinen Webbrowser und öffne die Datenbank-Verwaltung phpMyAdmin indem du die Adresse localhost:8888/phpmyadmin aufrufst. Wähle den Reiter "Datenbanken" aus. Im Feld "Datenbankname" trägst du den Namen ein, den du deiner Datenbank geben willst. In diesem Beispiel ist es contaotest. Die empfohlene Kollation – also die Regel nach der die Daten in der Datenbank einsortiert werden – ist utf8mb4_0900_ai_ci. Klicke auf "Anlegen".
Die Datenbank "contaotest" sollte jetzt in der linken Spalte ausgewählt sein. Wechsle auf den Reiter "Rechte" und lege dort mit "Benutzerkonto hinzufügen" einen neuen Benutzer an. Du musst hier einen Benutzernamen und ein Passwort vergeben. Als Administrator willst du natürlich alle Rechte auf die Datenbank, wähle deshalb die Optionen "Gewähre alle Rechte auf die Datenbank contaotest." und "Globale Rechte: Alle auswählen" an. Klicke links unten auf den Button "OK"! Der neue Benutzer wurde hinzugefügt.
Notiere dir den Datenbanknamen, den Benutzernamen und das Passwort!
Lade den Contao-Manager herunter; du findest ihn hier: https://contao.org/de/download.html
Ich verwende immer eine Version mit Long-Term-Support (LTS) für meine Kundenprojekte. Hier ist es die Version Contao 5.3 LTS. Lade dir die .phar-Datei herunter und übertrage sie in das Verzeichnis /public deiner Webseite. Benenne die Datei danach in contao-manager.phar.php um. Hinweis: Wenn du gefragt wirst "Möchtest du das Suffix wirklich von '.phar' in '.php' ändern?“ bestätigst du mit '.php verwenden'".
Öffne MAMP und klicke rechts oben auf "Start". Der Apache Webserver startet mit PHP und MySQL. Das Start-Icon wird grün.
Beginne nun mit der Contao-Installation, indem du den Contao-Manager in deinem Browser aufrufst. Wenn du den Port nicht verändert hast, ist localhost:8888/contao-manager.phar.php die richtige Adresse.
Lege zunächst den User-Account für den Contao-Manager an. Dazu vergibst du einen Username und ein Passwort und klickst auf "Create Account".
Im Verlauf der Contao-Installation musst du drei mal Zugangsdaten vergeben: Für den Contao-Manager, für das Contao-Installtool und das Contao-Backend. Notiere dir alle Usernamen und Passwörter!
Sicherheit ist ein wichtiges Thema, gerade bei Websites. Contao bietet eine Zwei-Faktor-Authentisierung (2FA) an. Dafür benötigst du ein Smartphone mit einer Authentifizierungs-App; zum Beispiel "Authenticator" von Microsoft. Auf der lokalen Entwicklungsumgebung ist eine 2FA nicht notwendig. Aber spätestens wenn du mit der Website auf einen Webserver umziehst, sollte Contao abgesichert sein. Also aktiviere die 2FA gleich jetzt, dann ist das erledigt.
Nun startet der System Check. Es wird zunächst geprüft, ob du Contao auf diesem Webserver installieren kannst. (Das klappt natürlich, weil du zuvor bereits alle richtig konfiguriert hast ;-) Weil sich noch keine Contao Installation auf dem Server befindet, musst du noch auf den Button "Setup" klicken.
Die Contao-Installation startet. Zunächst wird das "Webserver Setup" durchgeführt. Dabei werden automatisch deine Einstellungen übernommen, mit "Continue" bestätigst du sie.
Im nächsten Schritt wählst du deine bevorzugte Version aus; in diesem Beispiel ist es die Version 5.3 (Long Term Support). Du kannst gerne die Demo Website mitinstallieren. Klicke auf "Install"!
Halte die Daten für deine Datenbank bereit! Du musst sie jetzt korrekt eintragen, damit die Verbindung zwischen Contao und der Datenbank hergestellt werden kann. Klicke auf "Save"!
Wenn die Verbindung zur Datenbank steht, kannt der Contao Manager das Datenbankschema aufbauen. Klicke auf "Check database"!
Du kannst mitverfolgen, wie das Datenbankschema aufgebaut wird. Dann klicke auf "Execute". Du erhältst eine Bestätigung, wenn das db-Schema aktualisiert wurde. Klicke auf "Continue".
Jetzt kommen wir zu den Zugangsdaten für das Contao Backend. Beim Punkt „Backend Account“ vergibst du deine Zugangsdaten und Admin-Informationen. Hinweis: Die Zugangsdaten für das Contao-Backend sind unabhängig von denen für den Contao-Manager oder das Contao-Installtool. – Mit einem Klick auf "Add account" schließt du die Installation ab. – Voilá! Deine Installation war erfolgreich.
Du kannst jetzt das Contao-Backend aufrufen. Öffne ein Browser-Fenster und rufe das Contao-Backend mit der Adresse localhost:8888/contao auf. Gib die Zugangsdaten von deinem Administratorkonto ein. Du kannst jetzt mit der Arbeit an deiner neuen Contao-Website beginnen.
![Mit "[deinedomain]/contao" rufst du das Login-Fenster auf.](/files/eliaspartner_blog/260122_MAMP_Contao/20_Einloggen-im-Backend.jpg)
Fehler 404
Die Installation mit dem Contao Manager hat funktioniert, aber wenn du die Website aufrufen willst erhältst du eine Server-Fehlermeldung (Error 404)? Vergewissere dich, dass der Apache-Server richtig konfiguiert ist! Das mod_rewrite Modul muss aktiviert sein. Suche im MAMP-Ordner nach Mamp > conf > apache >httpd.conf und öffne die Datei mit einem Texteditor.
Suche nach der Zeile "#LoadModule rewrite_module modules/mod_rewrite.so" und entferne gegebenenfalls das #-Zeichen am Beginn. Damit wird aus einem Kommentar eine Anweisung. Das rewrite-Modul wird beim nächsten Neustart von MAMP geladen. Die Website ist jetzt in deinem Browser aufrufbar.
LoadModule rewrite_module modules/mod_rewrite.so
Port-Probleme
Ein Problem, dass immer wieder mit MAMP und Windows auftritt: Andere Tasks verwenden bereits die Ports, die MAMP verwenden möchte. Der MySQL-Port wird häufig von einem anderen Prozess verwendet; es kommt zu einem port conflict. In diesem Fall erhältst du eine Fehlermeldung bei der Installation eines CMS.
Du kannst die Ports aber ganz einfach in den Einstellungen von MAMP ändern: Wähle in den Einstellungenden Reiter "Ports" aus und dort z. B. das alternative Port-Set "80 & 3306" aus. Mit "OK" bestätigen.
Du kannst natürlich auch andere Ports auswählen. Du solltest dich zuvor aber vergewissern, dass diese Ports von keinem anderen Task verwendet werden. Anleitungen wie du deine aktuelle Port-Belegung herausfindest und wie du aktive Prozesse mit dem Task Manager beendest, findest du reichlich im Internet. Hinweis: Wenn du den Apache-Port änderst, musst du in der URL auch die neue Port-Nummer verwenden! Zum Beispiel localhost:80/contao (statt localhost:8888/contao)