Docker

2026-10-05T08:02:14Z

Tacoball: /* Overview */

== Overview ==

{| class="wikitable"
! style="width:200px;" | 🖼️ Images
! style="width:200px;" | 🛠️ Maintenance
! style="width:200px;" | ⚙️ Operation
|-
| valign="top" |
* [[Docker/Used Images List|Used Images List]]
| valign="top" |

| valign="top" |
* [[Docker/Debugging|Debugging]]
|-
! 🐳 docker-compose.yaml
! 📦 Dockerfile
!
|-
| valign="top" |

| valign="top" |

| valign="top" |

|}

== Installation ==

=== Ubuntu 26 ===

<syntaxhighlight lang="bash">
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo sh get-docker.sh --dry-run
docker --version
</syntaxhighlight>

== Clean Docker ==

{| class="wikitable"
! TODO || Command
|-
| Run debian image on Windows ||
<syntaxhighlight lang="bash">
# Git Bash
winpty docker run --name=debian0 -it debian:12

# Power Shell
docker run --name=debian0 -it debian:12
</syntaxhighlight>
|-
| Open shell of running container ||
<syntaxhighlight lang="bash">
docker exec -it mwdev-mediawiki-1 /bin/bash
</syntaxhighlight>
|-
| Copy file from running container ||
<syntaxhighlight lang="bash">
docker cp mwdev-mediawiki-1:/var/www/data/my_wiki.sqlite .
</syntaxhighlight>
|-
| Build image ||
<syntaxhighlight lang="bash">
docker build .
docker build -t gdtile:2.1 .
docker tag c8abdb693116 gdtile:2.1
</syntaxhighlight>
|-
| Remove exited containers ||
<syntaxhighlight lang="bash">
docker rm $(docker ps -f 'status=exited' -q)

sudo docker rm $(sudo docker ps -f 'status=exited' -q)
</syntaxhighlight>
|-
| Remove unused images ||
<syntaxhighlight lang="bash">
docker rmi $(docker images -f "dangling=true" -q)

sudo docker rmi $(sudo docker images -f "dangling=true" -q)
</syntaxhighlight>
|-
| run and start it again ||
<syntaxhighlight lang="docker">
docker run --name sandbox0 \
--volume a:b \
-it alpine:3.11
docker start -i sandbox0
</syntaxhighlight>
|-
| Make apt faster ||
<syntaxhighlight lang="docker">
FROM ubuntu:20.04

RUN sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
RUN apt update
</syntaxhighlight>

<syntaxhighlight lang="bash">
# In host
docker run -it ubuntu:20.04
# In container
sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
apt update
</syntaxhighlight>
|-
| Run ||
<syntaxhighlight lang="docker">
# Mapping directory on Windows, do not use ~
docker run -v C:\Users\User\repos\something:/docroot -it someimage bash
docker run -v %USERPROFILE%\repos\webserv:/docroot -it webserv-compose_web bash
</syntaxhighlight>
|-
| test ||
<syntaxhighlight lang="docker">
docker ps --size --all
</syntaxhighlight>
|-
| logs ||
<syntaxhighlight lang="docker">
docker ps logs -ft container
</syntaxhighlight>
|}

== Dockerfile Debugging ==

{| class="wikitable"
! TODO || Command
|-
| Verify environment variable (stdout won't be printed) ||
<syntaxhighlight lang="docker">
RUN export NVM_DIR="$HOME/.nvm"
RUN echo "NVM_DIR=$NVM_DIR" >&2
</syntaxhighlight>
|-
| ||
<syntaxhighlight lang="docker">
docker compose build --progress=plain
</syntaxhighlight>

|-
| ||
<syntaxhighlight lang="docker">
docker compose build --no-cache --progress=plain
</syntaxhighlight>
|}

2026-10-05T02:23:48Z

Tacoball: /* List */

== List ==

{| class="wikitable"
! Image || OS || Shell Command || Default Expose
|-
| mediawiki || Ubuntu || <syntaxhighlight lang="bash">sudo docker exec -it container_name bash</syntaxhighlight> || 80
|-
| yuzutech/kroki || Ubuntu || <syntaxhighlight lang="bash">sudo docker exec -it container_name bash</syntaxhighlight> || 8000
|-
| yuzutech/kroki-mermaid || Alpine || <syntaxhighlight lang="bash">sudo docker exec -it container_name sh</syntaxhighlight> || 8002
|-
| vllm/vllm-openai-xpu || || <syntaxhighlight lang="bash">sudo docker exec -it container_name bash</syntaxhighlight> || -
|-
| ghcr.io/berriai/litellm || || <syntaxhighlight lang="bash">sudo docker exec -it container_name bash</syntaxhighlight> || 4000
|-
| postgres || || <syntaxhighlight lang="bash">sudo docker exec -it container_name sh</syntaxhighlight> || 5432
|}

Docker/Used Images List

2026-10-05T02:22:24Z

Tacoball: /* List */

== List ==

{| class="wikitable"
! Image || OS || Shell Command || Default Expose
|-
| mediawiki || Ubuntu || <syntaxhighlight lang="bash">sudo docker exec -it container_name bash</syntaxhighlight> || 80
|-
| yuzutech/kroki || Ubuntu || <syntaxhighlight lang="bash">sudo docker exec -it container_name bash</syntaxhighlight> || 8000
|-
| yuzutech/kroki-mermaid || Alpine || <syntaxhighlight lang="bash">sudo docker exec -it container_name sh</syntaxhighlight> || 8002
|-
| vllm/vllm-openai-xpu || Ubuntu || <syntaxhighlight lang="bash">sudo docker exec -it container_name bash</syntaxhighlight> || 80
|-
| ghcr.io/berriai/litellm || Ubuntu || <syntaxhighlight lang="bash">sudo docker exec -it container_name bash</syntaxhighlight> || 8000
|-
| postgres || Alpine || <syntaxhighlight lang="bash">sudo docker exec -it container_name sh</syntaxhighlight> || 8002
|}

2026-10-05T02:14:39Z

Tacoball: /* Overview */

Docker

2026-10-05T01:36:15Z

Tacoball: /* Overview */

= Overview =

{| class="wikitable"
! style="width:200px;" | 🖼️ Images
! style="width:200px;" | 🛠️ Maintenance
! style="width:200px;" | ⚙️ Operation
|-
| valign="top" |

| valign="top" |

| valign="top" |

|-
! 🐳 docker-compose.yaml
! 📦 Dockerfile
!
|-
| valign="top" |

| valign="top" |

| valign="top" |

|}

= Clean Docker =

{| class="wikitable"
! TODO || Command
|-
| Run debian image on Windows ||
<syntaxhighlight lang="bash">
# Git Bash
winpty docker run --name=debian0 -it debian:12

# Power Shell
docker run --name=debian0 -it debian:12
</syntaxhighlight>
|-
| Open shell of running container ||
<syntaxhighlight lang="bash">
docker exec -it mwdev-mediawiki-1 /bin/bash
</syntaxhighlight>
|-
| Copy file from running container ||
<syntaxhighlight lang="bash">
docker cp mwdev-mediawiki-1:/var/www/data/my_wiki.sqlite .
</syntaxhighlight>
|-
| Build image ||
<syntaxhighlight lang="bash">
docker build .
docker build -t gdtile:2.1 .
docker tag c8abdb693116 gdtile:2.1
</syntaxhighlight>
|-
| Remove exited containers ||
<syntaxhighlight lang="bash">
docker rm $(docker ps -f 'status=exited' -q)

sudo docker rm $(sudo docker ps -f 'status=exited' -q)
</syntaxhighlight>
|-
| Remove unused images ||
<syntaxhighlight lang="bash">
docker rmi $(docker images -f "dangling=true" -q)

sudo docker rmi $(sudo docker images -f "dangling=true" -q)
</syntaxhighlight>
|-
| run and start it again ||
<syntaxhighlight lang="docker">
docker run --name sandbox0 \
--volume a:b \
-it alpine:3.11
docker start -i sandbox0
</syntaxhighlight>
|-
| Make apt faster ||
<syntaxhighlight lang="docker">
FROM ubuntu:20.04

RUN sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
RUN apt update
</syntaxhighlight>

<syntaxhighlight lang="bash">
# In host
docker run -it ubuntu:20.04
# In container
sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
apt update
</syntaxhighlight>
|-
| Run ||
<syntaxhighlight lang="docker">
# Mapping directory on Windows, do not use ~
docker run -v C:\Users\User\repos\something:/docroot -it someimage bash
docker run -v %USERPROFILE%\repos\webserv:/docroot -it webserv-compose_web bash
</syntaxhighlight>
|-
| test ||
<syntaxhighlight lang="docker">
docker ps --size --all
</syntaxhighlight>
|-
| logs ||
<syntaxhighlight lang="docker">
docker ps logs -ft container
</syntaxhighlight>
|}

= Dockerfile Debugging =

{| class="wikitable"
! TODO || Command
|-
| Verify environment variable (stdout won't be printed) ||
<syntaxhighlight lang="docker">
RUN export NVM_DIR="$HOME/.nvm"
RUN echo "NVM_DIR=$NVM_DIR" >&2
</syntaxhighlight>
|-
| ||
<syntaxhighlight lang="docker">
docker compose build --progress=plain
</syntaxhighlight>

|-
| ||
<syntaxhighlight lang="docker">
docker compose build --no-cache --progress=plain
</syntaxhighlight>
|}

Docker

2026-10-05T01:34:52Z

Tacoball: /* Overview */

= Overview =

{| class="wikitable"
! style="width:200px;" | Images
! style="width:200px;" | Maintenance
! style="width:200px;" | Operation
|-
| valign="top" |

| valign="top" |

| valign="top" |

|-
! docker-compose.yaml
! Dockerfile
!
|-
| valign="top" |

| valign="top" |

| valign="top" |

|}

= Clean Docker =

{| class="wikitable"
! TODO || Command
|-
| Run debian image on Windows ||
<syntaxhighlight lang="bash">
# Git Bash
winpty docker run --name=debian0 -it debian:12

# Power Shell
docker run --name=debian0 -it debian:12
</syntaxhighlight>
|-
| Open shell of running container ||
<syntaxhighlight lang="bash">
docker exec -it mwdev-mediawiki-1 /bin/bash
</syntaxhighlight>
|-
| Copy file from running container ||
<syntaxhighlight lang="bash">
docker cp mwdev-mediawiki-1:/var/www/data/my_wiki.sqlite .
</syntaxhighlight>
|-
| Build image ||
<syntaxhighlight lang="bash">
docker build .
docker build -t gdtile:2.1 .
docker tag c8abdb693116 gdtile:2.1
</syntaxhighlight>
|-
| Remove exited containers ||
<syntaxhighlight lang="bash">
docker rm $(docker ps -f 'status=exited' -q)

sudo docker rm $(sudo docker ps -f 'status=exited' -q)
</syntaxhighlight>
|-
| Remove unused images ||
<syntaxhighlight lang="bash">
docker rmi $(docker images -f "dangling=true" -q)

sudo docker rmi $(sudo docker images -f "dangling=true" -q)
</syntaxhighlight>
|-
| run and start it again ||
<syntaxhighlight lang="docker">
docker run --name sandbox0 \
--volume a:b \
-it alpine:3.11
docker start -i sandbox0
</syntaxhighlight>
|-
| Make apt faster ||
<syntaxhighlight lang="docker">
FROM ubuntu:20.04

RUN sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
RUN apt update
</syntaxhighlight>

<syntaxhighlight lang="bash">
# In host
docker run -it ubuntu:20.04
# In container
sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
apt update
</syntaxhighlight>
|-
| Run ||
<syntaxhighlight lang="docker">
# Mapping directory on Windows, do not use ~
docker run -v C:\Users\User\repos\something:/docroot -it someimage bash
docker run -v %USERPROFILE%\repos\webserv:/docroot -it webserv-compose_web bash
</syntaxhighlight>
|-
| test ||
<syntaxhighlight lang="docker">
docker ps --size --all
</syntaxhighlight>
|-
| logs ||
<syntaxhighlight lang="docker">
docker ps logs -ft container
</syntaxhighlight>
|}

= Dockerfile Debugging =

{| class="wikitable"
! TODO || Command
|-
| Verify environment variable (stdout won't be printed) ||
<syntaxhighlight lang="docker">
RUN export NVM_DIR="$HOME/.nvm"
RUN echo "NVM_DIR=$NVM_DIR" >&2
</syntaxhighlight>
|-
| ||
<syntaxhighlight lang="docker">
docker compose build --progress=plain
</syntaxhighlight>

|-
| ||
<syntaxhighlight lang="docker">
docker compose build --no-cache --progress=plain
</syntaxhighlight>
|}

Docker

2026-10-05T01:32:56Z

Tacoball: /* Overview */

= Overview =

{| class="wikitable"
! style="width:200px;" | Images
! style="width:200px;" | Maintainance
! style="width:200px;" | Operation
|-
| valign="top" |

| valign="top" |

| valign="top" |

|-
! 📦 Packages
! 📁 File System
! 📊 Data
|-
| valign="top" |

| valign="top" |

| valign="top" |

|}

= Clean Docker =

{| class="wikitable"
! TODO || Command
|-
| Run debian image on Windows ||
<syntaxhighlight lang="bash">
# Git Bash
winpty docker run --name=debian0 -it debian:12

# Power Shell
docker run --name=debian0 -it debian:12
</syntaxhighlight>
|-
| Open shell of running container ||
<syntaxhighlight lang="bash">
docker exec -it mwdev-mediawiki-1 /bin/bash
</syntaxhighlight>
|-
| Copy file from running container ||
<syntaxhighlight lang="bash">
docker cp mwdev-mediawiki-1:/var/www/data/my_wiki.sqlite .
</syntaxhighlight>
|-
| Build image ||
<syntaxhighlight lang="bash">
docker build .
docker build -t gdtile:2.1 .
docker tag c8abdb693116 gdtile:2.1
</syntaxhighlight>
|-
| Remove exited containers ||
<syntaxhighlight lang="bash">
docker rm $(docker ps -f 'status=exited' -q)

sudo docker rm $(sudo docker ps -f 'status=exited' -q)
</syntaxhighlight>
|-
| Remove unused images ||
<syntaxhighlight lang="bash">
docker rmi $(docker images -f "dangling=true" -q)

sudo docker rmi $(sudo docker images -f "dangling=true" -q)
</syntaxhighlight>
|-
| run and start it again ||
<syntaxhighlight lang="docker">
docker run --name sandbox0 \
--volume a:b \
-it alpine:3.11
docker start -i sandbox0
</syntaxhighlight>
|-
| Make apt faster ||
<syntaxhighlight lang="docker">
FROM ubuntu:20.04

RUN sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
RUN apt update
</syntaxhighlight>

<syntaxhighlight lang="bash">
# In host
docker run -it ubuntu:20.04
# In container
sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
apt update
</syntaxhighlight>
|-
| Run ||
<syntaxhighlight lang="docker">
# Mapping directory on Windows, do not use ~
docker run -v C:\Users\User\repos\something:/docroot -it someimage bash
docker run -v %USERPROFILE%\repos\webserv:/docroot -it webserv-compose_web bash
</syntaxhighlight>
|-
| test ||
<syntaxhighlight lang="docker">
docker ps --size --all
</syntaxhighlight>
|-
| logs ||
<syntaxhighlight lang="docker">
docker ps logs -ft container
</syntaxhighlight>
|}

= Dockerfile Debugging =

{| class="wikitable"
! TODO || Command
|-
| Verify environment variable (stdout won't be printed) ||
<syntaxhighlight lang="docker">
RUN export NVM_DIR="$HOME/.nvm"
RUN echo "NVM_DIR=$NVM_DIR" >&2
</syntaxhighlight>
|-
| ||
<syntaxhighlight lang="docker">
docker compose build --progress=plain
</syntaxhighlight>

|-
| ||
<syntaxhighlight lang="docker">
docker compose build --no-cache --progress=plain
</syntaxhighlight>
|}

Docker

2026-10-05T01:31:41Z

Tacoball:

= Overview =

{| class="wikitable"
! style="width:200px;" | 🌐 Networking
! style="width:200px;" | 💻 OS
! style="width:200px;" | 🛠️ Hardware
|-
| valign="top" |

| valign="top" |

| valign="top" |

|-
! 📦 Packages
! 📁 File System
! 📊 Data
|-
| valign="top" |

| valign="top" |

| valign="top" |

|}

= Clean Docker =

{| class="wikitable"
! TODO || Command
|-
| Run debian image on Windows ||
<syntaxhighlight lang="bash">
# Git Bash
winpty docker run --name=debian0 -it debian:12

# Power Shell
docker run --name=debian0 -it debian:12
</syntaxhighlight>
|-
| Open shell of running container ||
<syntaxhighlight lang="bash">
docker exec -it mwdev-mediawiki-1 /bin/bash
</syntaxhighlight>
|-
| Copy file from running container ||
<syntaxhighlight lang="bash">
docker cp mwdev-mediawiki-1:/var/www/data/my_wiki.sqlite .
</syntaxhighlight>
|-
| Build image ||
<syntaxhighlight lang="bash">
docker build .
docker build -t gdtile:2.1 .
docker tag c8abdb693116 gdtile:2.1
</syntaxhighlight>
|-
| Remove exited containers ||
<syntaxhighlight lang="bash">
docker rm $(docker ps -f 'status=exited' -q)

sudo docker rm $(sudo docker ps -f 'status=exited' -q)
</syntaxhighlight>
|-
| Remove unused images ||
<syntaxhighlight lang="bash">
docker rmi $(docker images -f "dangling=true" -q)

sudo docker rmi $(sudo docker images -f "dangling=true" -q)
</syntaxhighlight>
|-
| run and start it again ||
<syntaxhighlight lang="docker">
docker run --name sandbox0 \
--volume a:b \
-it alpine:3.11
docker start -i sandbox0
</syntaxhighlight>
|-
| Make apt faster ||
<syntaxhighlight lang="docker">
FROM ubuntu:20.04

RUN sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
RUN apt update
</syntaxhighlight>

<syntaxhighlight lang="bash">
# In host
docker run -it ubuntu:20.04
# In container
sed -i 's/$archive\|security$.ubuntu.com/free.nchc.org.tw/' /etc/apt/sources.list
apt update
</syntaxhighlight>
|-
| Run ||
<syntaxhighlight lang="docker">
# Mapping directory on Windows, do not use ~
docker run -v C:\Users\User\repos\something:/docroot -it someimage bash
docker run -v %USERPROFILE%\repos\webserv:/docroot -it webserv-compose_web bash
</syntaxhighlight>
|-
| test ||
<syntaxhighlight lang="docker">
docker ps --size --all
</syntaxhighlight>
|-
| logs ||
<syntaxhighlight lang="docker">
docker ps logs -ft container
</syntaxhighlight>
|}

= Dockerfile Debugging =

{| class="wikitable"
! TODO || Command
|-
| Verify environment variable (stdout won't be printed) ||
<syntaxhighlight lang="docker">
RUN export NVM_DIR="$HOME/.nvm"
RUN echo "NVM_DIR=$NVM_DIR" >&2
</syntaxhighlight>
|-
| ||
<syntaxhighlight lang="docker">
docker compose build --progress=plain
</syntaxhighlight>

|-
| ||
<syntaxhighlight lang="docker">
docker compose build --no-cache --progress=plain
</syntaxhighlight>
|}

Migration tips

2026-10-04T11:55:24Z

Tacoball: /* Steps */

== 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 ===

{| class="wikitable"
! Image
! Included Web Server
! PHP Execution Method
! Base OS
! Recommended Use Case
|-
| <code>mediawiki:1.43</code>
| Apache
| mod_php
| Debian
| Simple deployment with a single container
|-
| <code>mediawiki:1.43-fpm</code>
| None
| PHP-FPM
| Debian
| Use with Nginx or an existing Apache server
|-
| <code>mediawiki:1.43-fpm-alpine</code>
| None
| PHP-FPM
| Alpine Linux
| Smaller image size for users familiar with Alpine
|}

=== package versions ===

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

== from 1.39 to 1.47 ==

* Backup
** LocalSettings.php
** images
** database

<syntaxhighlight lang="bash">
docker compose exec mediawiki php maintenance/run.php update
</syntaxhighlight>