Line 1: |
Line 1: |
| [[Category:Software]] | | [[Category:Software]] |
| = Docker MediaWiki Server = | | = Docker MediaWiki Server = |
− |
| |
| Notes and configuration files for setting up MediaWiki with nginx-proxy for Let's Encrypt SSL certs. | | Notes and configuration files for setting up MediaWiki with nginx-proxy for Let's Encrypt SSL certs. |
| | | |
Line 11: |
Line 10: |
| | | |
| == nginx-proxy == | | == nginx-proxy == |
− |
| |
| * Create '''/srv/nginx-proxy''' | | * Create '''/srv/nginx-proxy''' |
| * Add this file | | * Add this file |
Line 57: |
Line 55: |
| | | |
| == MediaWiki == | | == MediaWiki == |
− |
| |
| * Create /srv/wiki, /srv/wiki/build, /srv/wiki/build/extensions | | * Create /srv/wiki, /srv/wiki/build, /srv/wiki/build/extensions |
| * Add the following files | | * Add the following files |
| | | |
| === docker-compose.yml === | | === docker-compose.yml === |
− |
| |
| Copy the following to '''/srv/wiki/docker-compose.yml''' | | Copy the following to '''/srv/wiki/docker-compose.yml''' |
| | | |
Line 75: |
Line 71: |
| - parsoid | | - parsoid |
| restart: always | | restart: always |
− | #ports:
| |
− | # - 80:80
| |
| environment: | | environment: |
| ## TODO: CHANGE VIRTUAL_HOST, LETSENCRYPT_HOST, and LETSENCRYPT_EMAIL TO YOUR OWN | | ## TODO: CHANGE VIRTUAL_HOST, LETSENCRYPT_HOST, and LETSENCRYPT_EMAIL TO YOUR OWN |
Line 87: |
Line 81: |
| volumes: | | volumes: |
| - /srv/wiki/html/images:/var/www/html/images | | - /srv/wiki/html/images:/var/www/html/images |
| + | ## TODO: remove the # below AFTER you have downloaded the LocalSettings.php file |
| #- /srv/wiki/LocalSettings.php:/var/www/html/LocalSettings.php | | #- /srv/wiki/LocalSettings.php:/var/www/html/LocalSettings.php |
| networks: | | networks: |
Line 109: |
Line 104: |
| | | |
| parsoid: | | parsoid: |
− | # image: pastakhov/parsoid:0.7.1
| |
| image: thenets/parsoid:0.10 | | image: thenets/parsoid:0.10 |
| container_name: parsoid | | container_name: parsoid |
Line 125: |
Line 119: |
| | | |
| === Dockerfile === | | === Dockerfile === |
| + | There are two ways to create the Dockerfile for MediaWiki. |
| + | |
| + | * simple uses the MediaWiki image and adds your extension(s) to it. |
| + | * advanced builds the MediaWiki image from scratch and adds your extension(s) to it. |
| + | |
| + | For most users, the simple version of the Dockerfile will suffice. |
| + | |
| + | Extract all extensions to the '''/srv/wiki/build/extensions''' directory. |
| | | |
| ==== Simple ==== | | ==== Simple ==== |
− |
| |
| Copy the following to '''/srv/wiki/build/Dockerfile''' | | Copy the following to '''/srv/wiki/build/Dockerfile''' |
| | | |
Line 269: |
Line 270: |
| | | |
| === Database connection details === | | === Database connection details === |
− |
| |
| When prompted for the database enter '''db://localhost''' | | When prompted for the database enter '''db://localhost''' |
| | | |
| === LocalSettings File === | | === LocalSettings File === |
− |
| |
| * Download when prompted | | * Download when prompted |
| * Stop the wiki with '''''docker-compose down''''' | | * Stop the wiki with '''''docker-compose down''''' |
Line 283: |
Line 282: |
| | | |
| == Misc == | | == Misc == |
| + | === Preventing access === |
| + | Note: You can also choose an access level at initial installation. |
| | | |
− | === Preventing access ===
| |
| https://www.mediawiki.org/wiki/Manual:Preventing_access#Simple_private_wiki | | https://www.mediawiki.org/wiki/Manual:Preventing_access#Simple_private_wiki |
| === Upgrading === | | === Upgrading === |
− | # Update in '''/srv/wiki/build/Dockerfile''' | + | IMPORTANT: Read https://www.mediawiki.org/wiki/Manual:Upgrading first for information about upgrading. |
| + | |
| + | # Update '''/srv/wiki/build/Dockerfile'''. Either update version (simple) or make sure Dockerfile has the required dependencies and update version (advanced). |
| # Run '''''docker-compose build''''' | | # Run '''''docker-compose build''''' |
| | | |
Line 294: |
Line 296: |
| # Run '''''docker-compose up -d''''' | | # Run '''''docker-compose up -d''''' |
| # Run '''''docker-compose exec web bash''''' | | # Run '''''docker-compose exec web bash''''' |
− | # '''''cd maintenance''''' | + | # Run '''''cd maintenance''''' |
− | # '''''php update.php''''' | + | # Run '''''php update.php''''' |
− | | |
− | For more information: https://www.mediawiki.org/wiki/Manual:Upgrading
| |