Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Neos
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Neos ist ein Open-Source-Content-Management-System aus dem Umfeld von TYPO3. Redakteure bearbeiten Texte und Bilder direkt in der Vorschau der Seite und sehen sofort, wie sie aussehen. Änderungen landen zuerst in einem persönlichen Arbeitsbereich und gehen erst nach dem Veröffentlichen online. Neos steht unter der freien Lizenz GPL-3.0.
Vorbemerkungen
- Kein apt-Paket: Neos ist nicht in den Ubuntu-Paketquellen enthalten. Es wird mit Composer installiert, dem Paketmanager für PHP. Composer, PHP, MariaDB und nginx kommen aus den Ubuntu-Paketquellen.
- Datenbank: Neos 9 speichert Inhalte nur in MariaDB oder MySQL. Mit PostgreSQL bricht die Einrichtung mit
Cannot build content graph for non mariadb/mysql connectionab. Diese Anleitung installiert MariaDB aus den Ubuntu-Paketquellen mit. - Voraussetzung: nginx ist installiert und läuft.
- Adresse: Neos läuft hier unter http://localhost:8095, nur vom eigenen Rechner aus erreichbar. Die Verwaltung liegt unter
/neos. - Eigentümer: Alle Dateien gehören dem Webserver-Benutzer
www-data, und auch Composer und die Neos-Befehle laufen alswww-data. - Betriebsart: Neos kennt die Betriebsarten („Kontexte“)
DevelopmentundProduction. Diese Anleitung verwendetProduction: schneller und ohne technische Fehlerdetails auf der Website. Deshalb beginnen alle Neos-Befehle mitFLOW_CONTEXT=Production, und nginx gibt denselben Wert an PHP weiter. - Version: Getestet mit Neos 9.1.9, PHP 8.5, Composer 2.9 und MariaDB 11.8 unter Ubuntu 26.04.
Pakete installieren
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. MariaDB, PHP, Erweiterungen und Composer installieren
mariadb-serverist die Datenbank. Sie startet nach der Installation von selbst und lauscht nur auf dem eigenen Rechner.php-fpmführt PHP-Dateien für nginx aus,php-mysqlverbindet PHP mit MariaDB.gdbearbeitet Bilder (Vorschaubilder, Zuschnitte).intl,zip,xml,mbstringundcurlbraucht Neos für Sprachen, Pakete, XML-Dateien, Umlaute und Downloads.composerlädt Neos und alle PHP-Bibliotheken, die es braucht.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install mariadb-server php-fpm php-mysql php-gd php-intl php-zip php-xml php-mbstring php-curl composer
Prüfen: Die Ausgabe beginnt mit Composer version 2.
composer --version
3. Ordner für Neos und den Composer-Zwischenspeicher anlegen
/var/www/neos nimmt die Website auf. Composer legt heruntergeladene Pakete im Home-Verzeichnis des Benutzers ab, das ist bei www-data der Ordner /var/www. Weil /var/www selbst root gehört, bekommt www-data dort einen eigenen Ordner .cache. -p verhindert einen Fehler, falls .cache von einer anderen Anleitung schon existiert.
sudo mkdir -p /var/www/neos /var/www/.cache
4. Ordner dem Webserver-Benutzer übergeben
sudo chown www-data:www-data /var/www/neos /var/www/.cache
Neos herunterladen
5. Neos-Projekt anlegen
create-project lädt die Grundausstattung neos/neos-base-distribution in Version 9.1 samt aller Bibliotheken nach /var/www/neos. Dazu gehört die Demo-Website Neos.Demo. cd /tmp davor ist nötig, weil www-data nicht in deinem Home-Verzeichnis arbeiten darf.
cd /tmp && sudo -u www-data composer create-project neos/neos-base-distribution /var/www/neos "^9.1"
Das Herunterladen dauert einige Minuten.
Prüfen: Die Ausgabe endet mit Please configure your database in the settings … und Neos setup not complete. Das ist richtig, die Datenbank folgt in den nächsten Schritten.
6. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd /var/www/neos
Prüfen: Die erste Zeile endet mit 9.1.9 ("Production" context) oder einer neueren Version.
sudo -u www-data FLOW_CONTEXT=Production ./flow help | head -1
Datenbank in MariaDB einrichten
Auf Ubuntu meldet sich root ohne Passwort an MariaDB an, wenn der Befehl mit sudo läuft. Das nutzen die nächsten drei Schritte.
7. Datenbank anlegen
utf8mb4 speichert alle Zeichen, auch Emojis.
sudo mariadb -e "CREATE DATABASE neos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
8. Datenbankbenutzer anlegen
Neos meldet sich mit diesem Benutzer bei MariaDB an. Ersetze geheimes_passwort durch ein eigenes Passwort und merke es dir für Schritt 10.
sudo mariadb -e "CREATE USER 'neos'@'localhost' IDENTIFIED BY 'geheimes_passwort';"
9. Dem Benutzer die Datenbank freigeben
sudo mariadb -e "GRANT ALL PRIVILEGES ON neos.* TO 'neos'@'localhost';"
Prüfen: Die Ausgabe enthält die Zeile GRANT ALL PRIVILEGES ON `neos`.* TO `neos`@`localhost` .
sudo mariadb -e "SHOW GRANTS FOR 'neos'@'localhost';"
Neos einrichten
10. Einstellungen anlegen
Eigene Einstellungen stehen in Configuration/Settings.yaml. Sie gelten für alle Betriebsarten.
sudo nano Configuration/Settings.yaml
Füge diesen Inhalt ein (Strg+Umschalt+V) und setze bei password dein Passwort aus Schritt 8 ein:
Neos:
Flow:
persistence:
backendOptions:
driver: pdo_mysql
host: localhost
dbname: neos
user: neos
password: geheimes_passwort
charset: utf8mb4
Neos:
userInterface:
defaultLanguage: de
persistence– die Verbindung zur Datenbank aus Schritt 7 bis 9.defaultLanguage: de– die Verwaltung erscheint auf Deutsch. Jeder Benutzer kann das später für sich ändern.
Die Einrückung mit Leerzeichen gehört zum Format YAML und muss genau so bleiben. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Einstellungsdatei dem Webserver-Benutzer übergeben
nano hat die Datei als root angelegt. Neos soll sie als www-data lesen.
sudo chown www-data:www-data Configuration/Settings.yaml
12. Datei mit dem Passwort schützen
Danach darf nur noch www-data die Datei lesen.
sudo chmod 600 Configuration/Settings.yaml
Prüfen: Die Zeile beginnt mit -rw------- und nennt zweimal www-data.
ls -l Configuration/Settings.yaml
13. Zwischenspeicher leeren
Neos liest geänderte Einstellungen erst nach dem Leeren des Zwischenspeichers. Das ist auch nach jeder späteren Änderung an Settings.yaml nötig.
sudo -u www-data FLOW_CONTEXT=Production ./flow flow:cache:flush
Prüfen: Die Ausgabe lautet Flushed all caches for "Production" context.
14. Tabellen anlegen
Legt die Tabellen für Benutzer, Medien und Einstellungen an.
sudo -u www-data FLOW_CONTEXT=Production ./flow doctrine:migrate
Prüfen: Die Ausgabe beginnt mit Migrating up to … und listet viele Zeilen mit CREATE TABLE. Ein zweiter Aufruf meldet nur noch Already at the latest version.
15. Content Repository einrichten
Das Content Repository speichert alle Seiten und Inhalte samt ihrer Änderungsgeschichte. Der Befehl legt die Tabellen dafür an.
sudo -u www-data FLOW_CONTEXT=Production ./flow cr:setup
Prüfen: Die Ausgabe lautet Content repository "default" was set up.
16. Demo-Website importieren
Importiert die Beispielwebsite mit Seiten, Bildern und einem Blog. Sie zeigt, was Neos kann, und dient als Vorlage für eigene Websites. Ihre Texte sind englisch.
sudo -u www-data FLOW_CONTEXT=Production ./flow site:importall --package-key Neos.Demo
Prüfen: Die Ausgabe endet mit Import finished.
17. Dateien der Website veröffentlichen
Kopiert Bilder, Stylesheets und Skripte in den Ordner Web/_Resources, aus dem nginx sie ausliefert.
sudo -u www-data FLOW_CONTEXT=Production ./flow resource:publish
Prüfen: Die Ausgabe endet mit einer Zeile wie Published 22.
18. Administratorkonto anlegen
Die Werte bedeuten der Reihe nach: Rolle, Benutzername, Passwort, Vorname, Nachname. Setze ein eigenes Passwort ein. Es landet dabei in der Befehlschronik des Terminals. Ändere es nach der ersten Anmeldung in der Verwaltung unter „Benutzereinstellungen“.
sudo -u www-data FLOW_CONTEXT=Production ./flow user:create --roles Administrator admin 'Ein-langes-Passwort-2026' Dein Name
Prüfen: Die Ausgabe lautet Created user "admin" and assigned the following role: Neos.Neos:Administrator.
nginx einrichten
19. Konfiguration für Neos anlegen
sudo nano /etc/nginx/sites-available/neos
Füge diesen Inhalt ein (Strg+Umschalt+V):
server {
listen 127.0.0.1:8095;
server_name localhost;
root /var/www/neos/Web;
index index.php;
client_max_body_size 64M;
location / {
try_files $uri /index.php$is_args$args;
}
location = /index.php {
include snippets/fastcgi-php.conf;
fastcgi_param FLOW_CONTEXT Production;
fastcgi_param FLOW_REWRITEURLS 1;
fastcgi_pass unix:/run/php/php-fpm.sock;
}
location ~ \.php$ {
return 404;
}
location ~ /\.(?!well-known) {
deny all;
}
}
root /var/www/neos/Web– nur der UnterordnerWebist über das Web erreichbar. Einstellungen, Bibliotheken und Daten liegen außerhalb.try_files … /index.php– alle Adressen ohne passende Datei gehen an Neos, auch die Verwaltung unter/neos.FLOW_CONTEXT Production– dieselbe Betriebsart wie bei den Befehlen.FLOW_REWRITEURLS 1– Neos erzeugt kurze Adressen wie/featuresstatt/index.php/features.- Neos braucht nur die Datei
index.php. Andere PHP-Dateien liefert nginx nicht aus (return 404). Der letzte Block sperrt versteckte Dateien.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
20. Konfiguration aktivieren
sudo ln -s /etc/nginx/sites-available/neos /etc/nginx/sites-enabled/neos
21. Konfiguration prüfen
sudo nginx -t
Prüfen: Die Ausgabe endet mit test is successful. Nur dann weiter.
22. nginx neu laden
sudo systemctl reload nginx
Neos verwenden
23. Website ansehen
Öffne http://localhost:8095 im Browser. Der erste Aufruf dauert etwa eine Sekunde, danach kommt die Seite aus dem Zwischenspeicher.
Prüfen: Die Demo-Website erscheint mit der Überschrift „Welcome to the Neos CMS 9.1 demo“ und einem Bild eines Bergsees.
24. An der Verwaltung anmelden
Öffne http://localhost:8095/neos und melde dich mit Benutzername und Passwort aus Schritt 18 an. Der Aufbau der Verwaltung dauert beim ersten Mal einige Sekunden.
Prüfen: Links stehen „Dokumentbaum“ und „Inhaltsbaum“, in der Mitte die Startseite, rechts die Eigenschaften der Seite. Oben rechts steht in Grün „Veröffentlicht - Public live workspace“.
25. Eine Seite bearbeiten und veröffentlichen
- Ändere rechts unter Dokument den Titel von „Home“ in
Startseite. - Klicke unten rechts auf Übernehmen. Die Änderung liegt jetzt in deinem persönlichen Arbeitsbereich. Besucher sehen sie noch nicht.
- Oben rechts steht jetzt Nach Public live workspace veröffentlichen mit der Zahl der Änderungen. Klicke darauf.
Texte in der Vorschau in der Mitte kannst du direkt anklicken und bearbeiten. Auch sie werden erst mit dem Veröffentlichen sichtbar.
Prüfen: Oben rechts steht wieder „Veröffentlicht - Public live workspace“. Lädst du http://localhost:8095 neu, steht im Menü „Startseite“.
Aktualisieren
Neos wird mit Composer aktualisiert. Lege vorher eine Sicherung an, mindestens der Datenbank und des Ordners /var/www/neos.
1. In den Projektordner wechseln
cd /var/www/neos
2. Pakete aktualisieren
Aktualisiert Neos innerhalb der Version 9.1 und alle Bibliotheken.
sudo -u www-data composer update
Prüfen: Die letzte Zeile lautet No security vulnerability advisories found.
3. Zwischenspeicher leeren
sudo -u www-data FLOW_CONTEXT=Production ./flow flow:cache:flush
4. Tabellen anpassen
Gibt es keine Änderungen, meldet der Befehl Already at the latest version.
sudo -u www-data FLOW_CONTEXT=Production ./flow doctrine:migrate
5. Content Repository anpassen
sudo -u www-data FLOW_CONTEXT=Production ./flow cr:setup
6. Dateien der Website neu veröffentlichen
sudo -u www-data FLOW_CONTEXT=Production ./flow resource:publish
Prüfen: sudo -u www-data FLOW_CONTEXT=Production ./flow help | head -1 zeigt die neue Versionsnummer.
Für den Sprung auf eine neue Neos-Version (z. B. 9.2) änderst du die Versionsangaben in composer.json. Lies dafür vorher die Hinweise unter https://docs.neos.io.
Deinstallieren
1. Seite in nginx deaktivieren
sudo rm /etc/nginx/sites-enabled/neos
2. nginx-Konfigurationsdatei löschen
sudo rm /etc/nginx/sites-available/neos
3. nginx prüfen und neu laden
sudo nginx -t
sudo systemctl reload nginx
4. Neos-Dateien löschen
Achtung: Damit sind auch alle hochgeladenen Bilder und Dateien gelöscht. Der Befehl cd /tmp sorgt dafür, dass du nicht mehr im gelöschten Ordner stehst.
cd /tmp && sudo rm -r /var/www/neos
5. Composer-Zwischenspeicher von www-data löschen
Nur wenn keine andere Anleitung (z. B. TYPO3 oder Contao) ihn noch braucht.
sudo rm -r /var/www/.cache
6. Datenbank löschen
Achtung: Damit sind alle Seiten, Inhalte und Benutzer der Website gelöscht.
sudo mariadb -e "DROP DATABASE IF EXISTS neos;"
7. Datenbankbenutzer löschen
sudo mariadb -e "DROP USER IF EXISTS 'neos'@'localhost';"
Prüfen: Die Seite ist nicht mehr erreichbar, curl meldet Failed to connect.
curl http://localhost:8095
8. MariaDB und Composer entfernen (optional)
Nur wenn kein anderes Programm MariaDB oder Composer braucht, z. B. Contao. Achtung: purge löscht auch alle übrigen Datenbanken in MariaDB. PHP und nginx bleiben installiert, weil andere Anleitungen sie ebenfalls verwenden.
sudo apt purge mariadb-server mariadb-common php-mysql composer
Fragt ein blauer Dialog, ob alle MariaDB-Datenbanken entfernt werden sollen, wähle Ja.
Der nächste Befehl entfernt die Pakete, die nur für MariaDB und Composer mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Prüfen: Die Ausgabe lautet mariadb: Kommando nicht gefunden (oder command not found).
mariadb --version
Quellen und Lizenz
- Offizielle Dokumentation: https://docs.neos.io/
- Lizenz: Neos steht unter der GPL-3.0.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.