Handbuch:Installation von MediaWiki
MediaWiki installiert sich selbst, indem es ein interaktives webbasiertes Installationsskript verwendet.
Before you can run this script, you need to do a couple of things: see prerequisites or short installation guide for experts.
Die Installation von MediaWiki kann für den durchschnittlichen Computeranwender schwierig werden, der keine Erfahrung mit Apache, PHP und MySQL/MariaDB hat. Most users who wish to use wiki software may benefit from using a free MediaWiki host or via a software bundle.
Herunterladen der MediaWiki-Software
Web browser
Download the MediaWiki tar file from the official download page. Generally, if you're using a production environment, you want to be running the latest stable release, which is mediawiki-1.35.1.tar.gz.
Command line (*nix machine)
Um MediaWiki 1.35.1, die neueste stabile Release-Version, auf einen *nix-Rechner herunterzuladen, kannst du den folgenden Befehl verwenden:
wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.1.tar.gz
Alternativ kannst du cURL benutzen.
curl -O https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.1.tar.gz
Die heruntergeladenen Dateien im Format .tar.gz
musst du vor der Weiterbearbeitung entpacken.
Entpacke die Dateien lokal oder auf deinem Server.
Unter Windows werden dafür gewöhnlich Programme wie 7-Zip (quelltextoffene Software), WinZip, WinRAR oder IZArc benutzt.
Unter Linux und Mac OS X kannst du die Datei entpacken (untar), indem du folgenden Befehl anwendest:
tar xvzf mediawiki-*.tar.gz
root:#
dekomprimierst, solltest du den Eigentümer der Dateien möglicherweise danach mit chown
ändern, sonst werden die Dateien unter dem Benutzer # 1000 (root) geführt, was möglicherweise nicht das ist, was du willst.Für Entwickler
Andererseits sollten Entwickler möglicherweise die Dateien von Git herunterladen, um ein lokales Repository mit dem aktuellsten Code einzurichten. Sie müssen auch Abhängigkeiten manuell über Composer installieren.
Dateien auf den Server hochladen
Wenn du die Dateien noch nicht auf deinen Webserver hochgeladen hast, tu dies jetzt.
Lade die Dateien in das Webverzeichnis deines Webservers hoch, in dem du entweder:
- das entpackte Verzeichnis direkt kopierst oder
- einen FTP-Clienten wie FileZilla (Open Source Software, Windows, OSX und Linux) oder Cyberduck (OSX) nutzt.
- by using cPanel File Manager (see below)
Wenn dein Kopier- oder FTP-Programm eine Option zur Umwandlung des Dateinamens in Kleinbuchstaben hat (change file names to lowercase), musst du diese ausschalten.
Wenn du Apache installiert hast, steht das korrekte Verzeichnis in deiner httpd.conf
-Datei (es ist die DocumentRoot-Richtlinie, normalerweise /var/www/
oder <apache-folder>/htdocs
).
Hinweis: Dies änderte sich in Ubuntu 14.04 mit Apache 2.4.7, wo die ursprüngliche Konfigurationsdatei für Apache-Server-Einstellungen und -Verzeichnisse /etc/apache2/apache2.conf
ist.
Wenn du einen Linux- oder Unix-Server benutzt, kannst du stattdessen die Dateien in ein beliebiges Verzeichnis des Servers kopieren und dann einen symbolischen Link zu diesem Ordner im Web-Verzeichnis Ihres Servers erstellen.
Benenne den hochgeladenen Ordner (oder den symbolischen Link) so um, wie du ihn in der URL haben willst.
Wenn dein Web-Server z. B. wie http://localhost
läuft, würde eine Umbenennung zu einem /w/
-Verzeichnis bedeuten, dass du dein Wiki über http://localhost/w/index.php
erreichst.
Benutze nicht /wiki/
, wenn du es als einen Kurzlink benutzen möchtest.
(Und richte Kurzlinks nicht ein, bis du das Installationsskript gestartet hast.)
index.php
die Fehlermeldung "500 Internal server Error ("500 Interner Serverfehler")" zeigt. Dies ist möglicherweise ein Berechtigungsfehler, welcher durch das Ändern der Datei- und Verzeichnisberechtigungen behoben werden kann, indem man den folgenden Befehl in SSH nach dem Ändern des Verzeichnis zu "w" ausführt:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
Dieser (umgenannte) Ordner wird nun als <MediaWiki-folder>
"bezogen".
cPanel File Manager
cPanel is a popular interface used by many web hosts. This method is efficient because the files are uncompressed on the server itself.
- Navigate to the directory where you want your wiki folder.
- Upload the mediawiki-1.xx.x.tar.gz file. You may need to hit "Reload" to see it.
- Extract the mediawiki-1.xx.x.tar.gz file. Reload again.
- Confirm that the mediawiki-1.xx.x folder is present.
- Delete the tar.gz file.
- Rename the mediawiki-1.xx.x folder to w.
Eine Datenbank erstellen
Sofern du das root-Passwort in deiner Datenbank kennst, kann das Installationsprogramm von MediaWiki eine Datenbank für dich erstellen. Sollte das der Fall sein, springe im Text zum Abschnitt „Das Installationsprogramm ablaufen lassen“ weiter unten auf dieser Seite. Wenn du das root-Passwort nicht kennst, z. B. wenn du auf einem gemieteten Server bist, musst du eine neue Datenbank erzeugen. Derzeit musst du entweder MariaDB/MySQL oder Postgres benutzen, um die aktuellen Inhalte des Wikis zu speichern. Wenn du dir nicht sicher bist, welche Datenbank du auswählen sollst, benutze MariaDB, da dies am besten von MediaWiki unterstützt wird.
SQLite
SQLite ist eine eigenständige Datenbankbibliothek, die die Datenbankinhalte in einer einzigen Datei speichert.
Wenn PHP das pdo-sqlite
-Modul hat, wird keine weitere Einrichtung benötigt.
Auf der Installationsseite musst du einen Datenbanknamen (welcher alles sein kann) und das SQLite-Datenbankverzeichnis angeben. For the database directory, the installer will attempt to use a subdirectory outside of the document root and create it if needed. If this directory is not safe (for example, web-readable), change it manually to avoid making it accessible to everyone on the web.
MariaDB/MySQL
MediaWiki will ask you for database and user name and will attempt to create them if they don't already exist. If doing so from MediaWiki is impossible, you can do this using various control panels such as PhpMyAdmin, which are often available from shared hosts, or you may be able to use ssh to login to your host and type the commands into a MySQL prompt. Siehe die entsprechende Dokumentation. Alternatively, contact your host provider to have them create an account for you.
CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Wenn deine Datenbank nicht auf dem gleichen Server wie dein Webserver läuft, musst du den zugehörigen Webserverhostnamen — im folgenden Beispiel mediawiki.example.com — wie folgt eingeben:
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';
PostgreSQL
Falls du PostgreSQL einsetzt, musst du entweder eine Datenbank und einen Benutzer für sich erzeugt haben, oder du stattest in der Konfiguration den Namen eines PostgreSQL-Benutzers mit "superuser"-Privilegien aus. Dieser Datenbankbenutzer wird häufig postgres genannt.
Here's one way to do most of the setup. Dies gilt für ein unixähnliches System. In diesem Beispiel werden wir eine Datenbank namens wikidb erstellen, die einem Benutzer namens wikiuser gehört. Führe - wie der Benutzer - die folgenden Schritte auf der Kommandozeile aus:
createuser -S -D -R -P -E wikiuser (gib dann das Passwort ein) createdb -O wikiuser wikidb
or as superuser (default postgres) execute the following commands at the database prompt:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password';
CREATE DATABASE wikidb WITH OWNER wikiuser;
Beware of the list of known issues when running MediaWiki with PostgreSQL.
Das Installationsskript ausführen
Once all of the above steps are complete, you can complete the installation through a web browser by going to the index.php URL in your browser — check the instructions mentioned in Manual:Config script .
The installation tool will prompt you to download the LocalSettings.php file, and to save this as <MediaWiki-folder>/LocalSettings.php
.
Alternatively, you can run the command-line installer or CLI: php maintenance/install.php
adding the appropriate configuration parameters.
Further steps
These are optional but make your site look so much better.
Keep up to date!
Once installed, make sure you stay up to date with releases, and keep your server secure!
Installation assistance
- Read the FAQ about installation and configuration
- Chat with MediaWiki developers, system administrators, and users: #mediawiki verbinden
- The mediawiki-l mailing List is the high-traffic list on which to ask for support
Siehe auch
- Manual:Page customizations/de - lists wiki pages that MediaWiki messages link to, you need to create these pages or edit the messages.
- Handbuch:MediaWiki konfigurieren - for links to more advanced configuration.
- Handbuch:Kurze URL - for having more user-friendly URL to article pages.
- Manual:Wiki-Familie - to set up multiple instances of MediaWiki with single set of MediaWiki files.
- Hilfe:Vorlagen
- Anleitung:Backup eines Wikis
- Manual:Moving a wiki
- Manual:Restoring a wiki from backup
- Manual:Aktualisierung