Migration tips

Steps

• Choose new image
• Update docker-compose.yaml
• Check docker-compose.yaml by docker compose config
• docker compose up
• List package versions
• Test extensions
• Check file system permissions

Choose new image

Comparison

Image	Included Web Server	PHP Execution Method	Base OS	Recommended Use Case
mediawiki:1.43	Apache	mod_php	Debian	Simple deployment with a single container
mediawiki:1.43-fpm	None	PHP-FPM	Debian	Use with Nginx or an existing Apache server
mediawiki:1.43-fpm-alpine	None	PHP-FPM	Alpine Linux	Smaller image size for users familiar with Alpine

package versions

docker pull mediawiki:1.43.9
docker run -it mediawiki:1.43.9 bash

cat /etc/os-release
php -v
php -m
curl -V

debug

Permission problem usually arize when upgrade new version. At that time, bash into the container is necessary for debugging.

sudo docker exec -it mw-main bash
sudo docker exec -it mw-main mmdc -V
sudo docker exec -it mw-main bash -c 'echo $PATH | tr ":" "\n"'

from 1.39 to 1.47

• Backup
  • LocalSettings.php
  • images
  • database

docker compose exec mediawiki php maintenance/run.php update