- Systemanforderungen
- Schnellanleitung
- Datenbank
- Download
- Upload
- Installationsvorgang
- Installation per Konsole
Für die Version 5.9 wird folgende Umgebung benötigt:
- PHP ab 7.1.3
- MySQL ab Version 5.5 oder MariaDB ab Version 10.0
Empfohlen: MySQL >=5.7.7 oder MariaDB >=10.2 für utf8mb4-Unterstützung
- Apache2, nginx oder ein vergleichbarer Webserver
Die folgenden Abschnitte erläutern das Vorgehen zur Installation von REDAXO auf einem Server oder Webspace.
- Eine MySQL-Datenbank erstellen und die Zugangsdaten notieren.
- Die neueste Version unter https://redaxo.org/download/core/ herunterladen.
- Die ZIP-Datei auf dem eigenen Rechner entpacken.
- Die entpackten Dateien in das Webverzeichnis hochladen und die Installation unter der Adresse der Website mit angehängtem /redaxo/ (http://deinedomain.tld/redaxo/) ausführen.
- Alle Installationschritte durchgehen.
Zunächst wird eine leere MySQL-Datenbank erstellt. Bei einigen Hostern ist bereits eine Datenbank angelegt, hierzu sollten die Zugangsdaten vorhanden sein. Für die Installation werden die Zugangsdaten (Datenbank-Name, Adresse des Servers, Datenbank-Benutzer und Passwort) für diese Datenbank benötigt.
Als Erstes die aktuelle Version von REDAXO unter https://redaxo.org/download/core/ herunterladen. Informationen zum aktuellen Release gibt es unter https://github.com/redaxo/redaxo/releases.
Das heruntergeladene Zip-File wird entpackt und der Inhalt in den Webordner des lokalen Servers oder via FTP, SFTP, WebDAV auf einen öffentlichen Webserver kopiert. Meist lautet der Webordner httpdocs , htdocs oder html.
Bei Upload per FTP/SFTP: Die Transfer-Einstellungen des FTP-Programms sollten auf binary/binär eingestellt sein.
Ausführliche Informationen zum Upload und zu den Zugangsdaten liefert der Hostingpartner.
Tipp: Einige Hoster bieten zur Verwaltung des Webspaces auch Oberflächen wie Plesk oder cPanel an. Hier enthalten ist auch ein Dateimanager, mit dem die Zip-Datei direkt hochgeladen und auf dem Server entpackt werden kann. Hinweis für Mac und Linux-User: Die versteckten .htaccess-Dateien müssen unbedingt mit übertragen werden. In einigen FTP-Programmen müssen diese erst eingeblendet werden.
Die Ordnerrechte müssen auf rwxrwxr-x (775) und die Dateirechte auf rw-r--r-- (644) gestellt werden. Es ist jedoch sinnvoller den Besitzer des Installationsordners mithilfe von chown zu ändern.
Nachdem REDAXO hochgeladen wurde, kann die Installation mit http://deinedomain.tld/redaxo/ aufgerufen werden. Die folgenden sieben Schritte führen durch die Installation.
Im ersten Schritt wird die Sprache für den Installationsvorgang und für das Backend festgelegt.
Hinweis : Die Sprache kann später im Setup oder für den User geändert werden.
REDAXO ist ein Open Source Projekt und kostenfrei. Allerdings gibt es Lizenzbedingungen, die akzeptiert werden müssen.
Schritt 2: Lizenz
An dieser Stelle führt die Installationsroutine einen Systemcheck durch und gibt ggf. Warnungen aus. Wenn etwas nicht stimmt, müssen eventuell auch die Systemvoraussetzungen überprüft werden.
Schritt 3: Systemcheck
Hinweis für Nginx-Nutzer
Nutzer des Nginx-Webservers erhalten eine Fehlermeldung über nicht geschützte Ordner. REDAXO liefert für Apache die nötigen htaccess-Dateien selber mit. Für nginx müssen die Direktiven selbst angelegt werden.
Direktiven für Nginx:
location ^~ /redaxo/src { deny all; }
location ^~ /redaxo/data { deny all; }
location ^~ /redaxo/cache { deny all; }
location ^~ /redaxo/bin { deny all; }
Bei der Verwendung eines Rewriter-AddOns bitte die Dokumentation des AddOns beachten.
An dieser Stelle wird die grundlegende Konfiguration durchgeführt.
- URL der Website mit abschließendem / (Slash)
- Name der Website
- E-Mail-Adressse bei Fehlern
- Zeitzone
- Datenbankverbindung
Befindet sich die Datenbank auf dem lokalen Server, kann hier localhost stehen gelassen werden. Bei einigen Hostern sind der Webspace und die Datenbank voneinander getrennt. In diesem Fall muss hier die Adresse des Datenbankservers eingeben werden.
Besitzt der Datenbank-User das Recht auch neue Datenbanken zu erstellen, so kann hier direkt eine neue Datenbank mit der oben angegebenen Bezeichnung anlegt werden.
Schritt 4: Systemcheck
Es muss eine der vier Optionen gewählt werden. Unterstützt der Datenbankserver utf8mb4, wird eine entsprechende Option zur Auswahl angeboten.
Hinweis : Eine Aktualisierung von REDAXO-Versionen kleiner als 5 ist aktuell nicht vorgesehen.
Schritt 5: Datenbank
Nun muss ein Username und ein sicheres Passwort für den Administrator der REDAXO-Installation definiert werden. Sichere Passwörter haben mehr als sechs Zeichen und beinhalten Groß- und Kleinbuchstaben sowie Sonderzeichen. Auch sollte nicht unbedingt Admin oder Administrator als Benutzername anlegt werden; diese sind zu leicht zu erraten.
Schritt 6: Administrator
Die Installation ist erfolgreich. Beachte die weiteren Hinweise auf der Seite. Die Erste Anmeldung kann nun direkt über den Button Zum Login erfolgen. Alternativ kann auch /redaxo/ hinter die URL der Installation im Browser eingeben werden, um in das Backend zu gelangen. (Zum Beispiel www.domain.xy/redaxo)
Schritt 7: Ende
Nach der Installation: Es ist durchaus möglich, dass nach einem Release noch Updates nachgereicht werden. Daher sollte nach der Installation im Installer geprüft werden, ob Aktualisierungen vorliegen.
REDAXO kann alternativ auch über die Konsole redaxo/bin/console installiert werdern.
Der Befehl lautet php console setup:run für den interaktiven Modus.
Die Hilfe per php console setup:run --help liefert mögliche Optionen und Modi.
u.a.:
--quietfür eine Unterdrückung aller Ausgaben--no-interactionfür keine Interaktion
Mit der REDAXO Konsole können viele gängige Operationen durchführt werden, wie z. B. Installation, setzen von Config-Settings, Installation / Deinstallation von AddOns (packages)