Migration tips: Difference between revisions

Latest revision as of 11:55, 4 October 2026

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

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

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

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"'

docker compose exec mediawiki php maintenance/run.php update

@@ Line 1: / Line 1: @@
+== 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 ==
@@ Line 33: / Line 43: @@
 <syntaxhighlight lang="bash">
 docker pull mediawiki:1.43.9
+docker run -it mediawiki:1.43.9 bash
+cat /etc/os-release
+php -v
+php -m
+curl -V
+</syntaxhighlight>
+=== debug ===
+Permission problem usually arize when upgrade new version.
+At that time, bash into the container is necessary for debugging.
+<syntaxhighlight lang="bash">
+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"'
 </syntaxhighlight>