Installation in fünf Schritten

Das SEO CMS gibt es nur als Leistung von SEO NW, einen Download oder eine Lizenz gibt es nicht. SEO NW richtet das System ein, zieht bestehende Seiten um und betreut sie.

Composer oder Node braucht es nicht. Gebraucht werden Webspace mit PHP 8.3 oder neuer samt PDO für MySQL, eine leere Datenbank ab MySQL 5.7 oder MariaDB 10.3 und ein Apache mit mod_rewrite, der die .htaccess auswertet. Das ist bei Apache keine Selbstverständlichkeit: Steht AllowOverride auf dem Standardwert None, ignoriert der Server .htaccess-Dateien vollständig ^[1]. Ob dein Hoster die .htaccess auswertet, lässt sich vorher erfragen.

Zur PHP-Fassung: Die Mindestfassung ist 8.3. PHP 8.1 bekommt seit dem 31.12.2025 keine Sicherheitsupdates mehr ^[2], für 8.2 enden sie am 31.12.2026, für 8.3 am 31.12.2027 ^[3].

Schritt 1: Dateien hochladen

Der Inhalt des Pakets liegt direkt im Dokumentenstammverzeichnis der Domain, nicht in einem Unterordner. Die Ordner sites/ und config/ müssen für PHP beschreibbar sein, weil das Setup dort die Mandantendaten und später die erzeugten Seiten ablegt.

Schritt 2: Datenbank anlegen

Beim Hoster entsteht eine leere Datenbank mit eigenem Benutzer, deren Name und Zugangsdaten das Setup abfragt. Ein häufiger Stolperstein zeigt sich erst später: Viele Hoster legen Datenbankbenutzer je Datenbank an. Sollen mehrere Mandanten über die zentrale Datenbankverwaltung laufen, braucht es einen Benutzer, der auf alle betroffenen Datenbanken zugreifen darf.

Schritt 3: Token setzen

In config/install.php kommt ein eigenes Token, am besten eine zufällige Zeichenfolge. Solange dort noch der mitgelieferte Beispielwert steht, verweigert das Setup den Dienst. Der Schritt schützt die Einrichtung: Ohne Token könnte jeder, der die Adresse kennt, einen Mandanten anlegen.

Schritt 4: Setup im Browser aufrufen

Dann wird /setup.php auf der Domain aufgerufen. Das Formular fragt nach dem Token, dem Projektschlüssel, der Domain, den Datenbankangaben und danach, ob dieses Projekt das Portal sein soll. Danach legt das Setup die Tabellen an, setzt die Einstellungen, trägt die Domain in die .htaccess ein und baut die ersten Seiten.

Das Setup läuft im Browser und nicht per SSH als root. Alle erzeugten Dateien gehören dann dem PHP-Benutzer, also genau dem, der später aus dem Backend heraus neu baut. Wer zuerst als root installiert, bekommt Dateien, die der Webserver nicht mehr überschreiben darf, und der Build aus dem Backend scheitert.

Schritt 5: Aufräumen

• Token in config/install.php leeren oder die Datei löschen.
• Das Admin-Passwort unter /admin/password.php ändern.
• Prüfen, ob die Domain in der .htaccess steht. Das Setup trägt sie nur ein, wenn die Datei beschreibbar war.

Neue Mandanten stehen auf nicht indexierbar, mit noindex auf jeder Seite und einer robots.txt, die alles sperrt. Den Schalter site_indexable stellst du erst um, wenn echter Inhalt da ist, und baust danach neu. Was der Schalter alles steuert, beschreibt die Funktionsgruppe Indexierung, Sitemap und robots.txt.

Portal oder Einzelseite?

Ein Portal legt seine Seiten unter sites/_root/ ab, schaltet die Mandantenverwaltung im Backend frei und trägt später installierte Projekte automatisch in Verzeichnis und Liste ein. Eine Einzelseite legt ihre Seiten unter sites/ mit ihrem Schlüssel ab. Beim ersten Projekt auf einer Domain ist Portal meist die bessere Wahl, auch wenn es vorerst bei einem Projekt bleibt. Umstellen geht später, kostet aber einen Neubau und die Umbenennung des Ausgabeordners.

Weitere Mandanten einrichten

Für eine Subdomain der bestehenden Domain braucht es einen Eintrag in config/tenants.php oder in der Mandantenverwaltung, eine Konfigurationsdatei unter config/tenants/, eine Datenbank und einen Lauf von install-tenant.php mit dem Schlüssel. Die Weiche in der .htaccess löst Subdomains selbst auf. Für eine zusätzliche eigene Domain kommt eine Regelzeile in der .htaccess dazu. Wie die Mandanten zusammenspielen, steht unter Mandanten und Portale.

Kommt später eine neue Fassung des CMS dazu, läuft der Installer einmal je Mandant, zum Beispiel mit der Option --no-build. Nur der Installer legt neue Tabellen und Spalten an, der Build erzeugt ausschließlich Seiten. Vorhandene Inhalte und der Admin-Zugang bleiben dabei unverändert.

Wenn etwas nicht geht

• "Unbekannter Host": Die Domain fehlt im Mandantenregister oder in der .htaccess.
• "Datenbank existiert nicht": Der Name stimmt nicht, oder die zentrale Datenbankverwaltung überschreibt ihn.
• "kein Zugriff": Der Benutzer hat keine Rechte auf genau diese Datenbank.
• Der Build scheitert aus dem Backend: Vermutlich wurde zuerst als root installiert. Prüf den Eigentümer von sites/.
• Das CSS fehlt: Der Ordner shared/ wurde nicht mit hochgeladen, oder die .htaccess greift nicht.
• Alle Seiten tragen noindex: Der Schalter site_indexable steht noch auf 0. Das ist die Voreinstellung.

Begriffe wie Mandant oder Seed-Datei erklärt das Lexikon des SEO CMS, die Grundlagen zur Datei .htaccess das Glossar unter .htaccess.

Du willst das SEO CMS für dein Projekt nutzen? Im Erstgespräch für 1 Euro klärst du mit Alexander Müller, ob es zu deinem Vorhaben passt. Was SEO NW dabei übernimmt, beschreibt die Seite SEO CMS Agentur. Einzelne Fragen zu einer bestehenden Installation kannst du in die gratis Sprechstunde mitbringen. Sie findet jeden ersten Samstag im Monat um 18 Uhr statt, ohne Anmeldung und mit 30 Minuten je Person.

1. Organisation Apache HTTP Server Tutorial: .htaccess files. The Apache Software Foundation. Stand laufend. abgerufen am 31.10.2026
2. Organisation Unsupported Branches. The PHP Group. Stand laufend. abgerufen am 31.10.2026
3. Organisation Supported Versions. The PHP Group. Stand laufend. abgerufen am 31.10.2026

Zuletzt geprüft am 03.11.2026, nächste Prüfung spätestens im November 2027. Fehler entdeckt? Schreib uns.