MediaWiki: Difference between revisions
imported>Mweinelt |
Phanirithvij (talk | contribs) m fix mediawiki extension url |
||
(11 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
[https://mediawiki.org/ {{PAGENAME}}] ([[wikipedia:en:{{PAGENAME}}]]) is available as a [[module]]. | [https://mediawiki.org/ {{PAGENAME}}] ([[wikipedia:en:{{PAGENAME}}]]) is available as a [[module]]. | ||
== | == Configuration Examples == | ||
=== Small Configuration === | |||
<syntaxhighlight lang="nix"> | <syntaxhighlight lang="nix"> | ||
services.mediawiki = { | services.mediawiki = { | ||
enable = true; | enable = true; | ||
name = "Sample MediaWiki | name = "Sample MediaWiki"; | ||
virtualHost = { | httpd.virtualHost = { | ||
hostName = "example.com"; | hostName = "example.com"; | ||
adminAddr = "admin@example.com"; | adminAddr = "admin@example.com"; | ||
}; | }; | ||
# Administrator account username is admin. | |||
# Set initial password to "cardbotnine" for the account admin. | |||
passwordFile = pkgs.writeText "password" "cardbotnine"; | |||
extraConfig = '' | extraConfig = '' | ||
# Disable anonymous editing | # Disable anonymous editing | ||
Line 31: | Line 26: | ||
# https://www.mediawiki.org/wiki/Extension:TemplateStyles | # https://www.mediawiki.org/wiki/Extension:TemplateStyles | ||
TemplateStyles = pkgs.fetchzip { | TemplateStyles = pkgs.fetchzip { | ||
url = "https://extdist.wmflabs.org/dist/extensions/TemplateStyles-REL1_40- | url = "https://extdist.wmflabs.org/dist/extensions/TemplateStyles-REL1_40-5c3234a.tar.gz"; | ||
hash = "sha256- | hash = "sha256-IygCDgwJ+hZ1d39OXuJMrkaxPhVuxSkHy9bWU5NeM/E="; | ||
}; | }; | ||
}; | }; | ||
}; | }; | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Web Server == | |||
By default, the <code>services.mediawiki</code> module creates a <code>services.httpd.virtualHost</code> which can be configured via the <code>services.mediawiki.httpd.virtualHost</code> submodule. | |||
If you are using another web server (like [[Nginx]]), you can configure MediaWiki for a reverse proxy with the <code>services.mediawiki.virtualHost.listen</code> option: | |||
If you are using another web server (like Nginx), you can configure MediaWiki for a reverse proxy with the <code>services.mediawiki.virtualHost.listen</code> option: | |||
<syntaxhighlight lang="nix"> | <syntaxhighlight lang="nix"> | ||
services.mediawiki.virtualHost.listen = [ | services.mediawiki.httpd.virtualHost.listen = [ | ||
{ | { | ||
ip = "127.0.0.1"; | ip = "127.0.0.1"; | ||
Line 59: | Line 49: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Alternatively, <code>services.mediawiki.webserver</code> can be set to <code>"nginx"</code> to use nginx instead of [[Apache HTTP Server|apache]]. | |||
== Troubleshooting == | |||
=== Edit php.ini === | |||
A [[Phpfpm|php-fpm]] pool is automatically created when Mediawiki is enabled. The <code>php.ini</code> file can be modified by using <code>phpOptions</code>. The following example shows how to increase the allowed file upload size. | |||
<syntaxhighlight lang="nix"> | |||
services.phpfpm.pools.mediawiki.phpOptions = '' | |||
upload_max_filesize = 10M | |||
post_max_size = 15M | |||
''; | |||
</syntaxhighlight> | |||
== See Also == | |||
* [https://github.com/NixOS/nixos-wiki-infra Configuration of the NixOS wiki] | |||
* [https://github.com/NixOS/nixpkgs/blob/master/nixos/tests/mediawiki.nix nixos/tests/mediawiki.nix] | |||
* [[Dokuwiki]], simple PHP- and web-based wiki software which uses file based storage for its content. | * [[Dokuwiki]], simple PHP- and web-based wiki software which uses file based storage for its content. | ||
* [[Outline]], a modern web based wiki and knowledge base for teams. | * [[Outline]], a modern web based wiki and knowledge base for teams. | ||
[[Category:Guide]] | [[Category:Guide]] | ||
[[Category:Server]] | |||
[[Category:Web Applications]] | [[Category:Web Applications]] |