Install

1. Make sure to comment out - ./LocalSettings.php:/var/www/html/LocalSettings.php in docker-compose.yaml and run docker-compose up --build -d. An error will be raised if you use an existing LocalSettings.php. (Oct 2024 update: There was a breaking change in Docker image version 1.39, so we may need to use version 1.38 or earlier in docker-compose.yaml to run this repository)

2. Visit http://localhost:8080/

3. Click Please set up the wiki first. and select a language

4. Continue

5. Set up database

Database host: database (must be the same as the container name of mariadb)

Database name: (must be the same as MYSQL_DATABASE of docker-compose.yaml)

Database username: (must be the same as MYSQL_USER of docker-compose.yaml)

Database password: (must be the same as MYSQL_PASSWORD of docker-compose.yaml)

6. Continue

7. Set up wiki admin account and select I'm bored already, just install the wiki. if a detailed configuration is not needed.

8. Continue

9. LocalSettings.php will be downloaded automatically.

10. Stop all the containers with docker-compose down and Put LocalSettings.php in the root directory of the repo.

11. (Important) Change $wgDefaultSkin = "vector"; to $wgDefaultSkin = "vector-2022"; in LocalSettings.php

12. (Optional) Add the following lines below $wgDefaultSkin in order to display errors in your browser, if any. This will help you enable error display and debugging features for your MediaWiki installation.

error_reporting( -1 );
ini_set( 'display_errors', 1 );

$wgShowExceptionDetails = true;
$wgShowDBErrorBacktrace = true;

13. (Important) Uncomment - ./LocalSettings.php:/var/www/html/LocalSettings.php in docker-compose.yaml to apply the configuration in LocalSettings.php

14. run docker-compose up --build -d again.

15. Sign in with the admin account

Check files in docker containers

docker exec -it --user=root {container id from docker ps} bash

e.g.,
docker exec -it --user=root 24a696c42c95 bash

Customizing CSS

Vector/resources/common/variable.less

• Change the hex code of @background-color-secondary

MediaWiki References

• Github

• Manual:How to make a MediaWiki skin

• Custom pages

• Object Factory