Tato stránka popisuje kroky k ruční instalaci MediaWiki, přičemž další konfigurační kroky naleznete na stráncePříručka:System_administration#Konfigurace.
Tato stránka popisuje kroky potřebné k ruční instalaciMediaWiki. Po instalaci lze další podrobnosti o konfiguraci nalézt na stráncePříručka:Správa systému#Konfigurace.
Instalace MediaWiki vyžaduje základní znalost používání webového hostitele.Je to jednodušší, pokud máte nějaké zkušenosti s Apache (software webového serveru), PHP a MySQL/MariaDB (databáze).Máte-li jakékoli dotazy týkající se instalací MediaWiki, zeptejte seProject: Support desk nebo se podívejte na jiná místa uvedená naKomunikace.
SekceDodatky níže nabízíalternativy k ruční instalaci spolu se specifickými poznámkami k instalaci pro různé konfigurace systému.
Pro rychlejší nastavení lokálního serveru MediaWiki se podívejte na stránkuLocal development quickstart.
Zkontrolujte, zda váš systém splňujeinstalační požadavky.
Nezapomeňte také zkontrolovatPoznámky k vydání verze MediaWiki, kterou plánujete nainstalovat.
Stáhněte si soubor tar MediaWiki zoficiální stránky pro stažení.
Pokud používáte MediaWiki vprodukčním prostředí, vydal správce vydání důrazné doporučení, že by se měly používat v produkčním prostředí pouze verze uvedené na stránceŽivotní cyklus verze a její konec jako aktuální "stabilní verze", "starší verze" nebo "verze dlouhodobé podpory".Starší verze mohou obsahovat kritickou bezpečnostní zranitelnost a další závažné chyby, včetně hrozby možné ztráty a nebo poškození dat.Aktuální stabilní verze je MediaWiki 1.44.0.
Stažený soubor je ve formátu.zip nebo.tar.gz.Před použitím musíte tento archivní soubor rozbalit.Soubor můžete dekomprimovat lokálně (a poté nahrát přes FTP na server) nebo přímo na vašem serveru.
Ve Windows se dekomprimace obvykle provádí pomocí softwaru, jako je7-Zip (zdarma),WinZip,WinRAR neboIZArc (zdarma).
V systémech Linux a Mac OS X můžete soubor dekomprimovat pomocí tohoto příkazu:tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> Další informace o zabezpečení oprávnění k souborům naleznete na stráncePříručka:Zbezpečení#Oprávnění k souboru.Pokud jste ještě nenahráli soubory na vášwebový server (nebo je zkopírovali, pokud software vašeho webového serveru běží lokálně na vašemlocalhost), udělejte tak nyní.
Nahrajte soubory do úložiště serveru buď:
Pokud váš nástroj pro nahrávání obsahuje možnost "změnit názvy souborů na malá písmena", musíte tuto možnost zakázat, abyste zabránili nechtěným úpravám názvů souborů během procesu nahrávání.
Pokud používáte webový server Apache HTTPD, správný adresář je uveden ve vašem souboruhttpd.conf v direktivěDocumentRoot.Ve výchozím nastavení je to/var/www/ nebo<apache-folder>/htdocs.
Přesné umístění nastavení serveru Apache a souboru adresářůhttpd.conf závisí na vašem operačním systému.V Debianu a Ubuntu je soubor pro nastavení a adresáře serveru Apache/etc/apache2/apache2.conf.V Red Hatu a Fedoře je soubor/etc/httpd/conf/httpd.conf.
Přejmenujte nahranou složku na požadovaný název, protože to určí, jak se zobrazí v adrese URL.Pokud například přejmenujete složku nawiki, URL odkáže naexample.com/wiki.Pokud váš webový server pracuje například jakohttp://localhost, přejmenování na adresář/w/ by znamenalo, že byste přistupovali ke své wiki jakohttp://localhost/w/index.php.
/wiki/ zatím nepoužívejte, pokud chcete nastavitkrátkou URL po spuštěnípočátečního konfiguračního skriptu.Počáteční konfigurační skript MediaWiki vyžaduje název databáze a uživatelské jméno databáze pro uložení obsahu wiki.
Pokud již máte databázový server a znáte heslo pro uživatele "root" (admin), přejděte na část#Spustit instalační skript níže.
Pokud neznáte heslo pro uživatele root, například pokud jste nahostovaném serveru, budete muset před spuštěním instalačního skriptu MediaWiki v další části vytvořit novou databázi.
MariaDB/MySQL jsou doporučené databáze. PostgreSQL a SQLite mají omezenou podporu a neměly by se používat, pokud k tomu není důvod. Pokud si nejste jisti, kterou databázi zvolit, použijte MariaDB.
Po dokončení nastavení databáze pokračujte níže#Spuštění instalačního skriptu.
Pokud je v systému nainstalován modulpdo-sqlite pro PHP, proSQLite není potřeba žádné další nastavení.
Na instalační stránce SQLite vyberte název databáze (libovolný) a adresář databáze SQLite. V adresáři databáze se instalační program pokusí použít podadresář mimo kořen dokumentu a v případě potřeby jej vytvořit.Pokud tento adresář není bezpečný (například čitelný na webu), změňte jej ručně. Pro zabránění jeho zpřístupnění všem na webu.
Vytvořte databázi a uživatele databázeMariaDB/MySQL.
Následující příkazy vytvoří databázi s názvemmy_wiki, uživatele s názvemwikiuser a nastaví v této databázi oprávnění pro uživatele.
CREATEDATABASEmy_wiki;CREATEUSER'wikiuser'@'localhost'IDENTIFIEDBY'database_password';GRANTALLPRIVILEGESONmy_wiki.*TO'wikiuser'@'localhost'WITHGRANTOPTION;
Pouze pokud vaše databáze neběží na stejném serveru jako váš webový server, musíte zadat příslušný název hostitele webového serveru (mediawiki.example.com v příkladu níže):
GRANTALLPRIVILEGESONmy_wiki.*TO'wikiuser'@'mediawiki.example.com'IDENTIFIEDBY'database_password';
 Varování: | MySQL/MariaDB zaznamenává všechny dotazy do souboru historie. Bude obsahovat heslo databáze pro uživatelský účet. Pokud se vás to týká, smažte a deaktivujte soubor.mysql_history po spuštění těchto dotazů podle [dokumentacehttps://dev.mysql.com/doc/refman/8.0/en/mysql-logging.html#mysql-logging-history-file MySQL]. |
Pokud používátePostgreSQL, musíte mít buď vytvořenou databázi a uživatele nebo jednoduše do konfiguračního formuláře zadat jméno uživatele PostgreSQL s oprávněními "superuživatele" (superuser).Tím je často uživatel databáze s názvempostgres.
Následující příkazy na příkazovém řádku Linuxu jako uživatel postgres vytvoří uživatele databáze s názvemwikiuser a databázi s názvemmy_wiki vlastněnou uživatelem jménemwikiuser.
createuser -S -D -R -P -E wikiuser (poté zadejte heslo databáze) createdb -O wikiuser my_wiki
nebo jako superuser (výchozí postgres) spusťte na příkazovém řádku databáze následující příkazy:
CREATEUSERwikiuserWITHNOCREATEDBNOCREATEROLENOSUPERUSERENCRYPTEDPASSWORD'database_password';CREATEDATABASEmy_wikiWITHOWNERwikiuser;
Dejte pozor naseznam známých problémů při spuštění MediaWiki s PostgreSQL.
Dále dokončete instalaci MediaWiki tak, že ve webovém prohlížeči přejdete na adresu URL vaší instalace MediaWiki: Postupujte podle pokynů na stráncePříručka:Konfigurační skript.
Po instalaci se ujistěte, že budete neustále informováni o vydáních a udržujte svůj server v bezpečí!
Přihlaste se k odběru našich emailových oznámení o nových verzích MediaWiki
Ruční instalace je často preferovanou metodou, protože poskytuje uživateli větší kontrolu a přehled o tom, jak je jeho wiki nainstalována, což usnadňuje odstraňování problémů a údržbu. Automatizované procesy, balíčky, balíčky a služby mají všechny své vlastní zvláštnosti.
Místo ruční instalace MediaWiki mohou být alternativní možnosti jednodušší:
Více na stráncecomparison of distribution options.
Na stráncePříručka:Nápověda pro konkrétní OS najdete podrobnější pokyny k instalaci zaměřené na konkrétní systémy.
Celkově jsou však tyto dokumenty pro jednotlivé systémy méně udržované a nemusí být vždy aktuální.Nejprve se podívejte naInstalace MediaWiki (tuto stránku), než se podíváte na dokumentaci k instalaci jednotlivých systémů.
VizPříručka:FAQ#Instalace a konfigurace.
VizPříručka:FAQ#Instalace a konfigurace.